Docs: Add local preview for documentation

[robbymilo]

What this PR does:

Adds a local preview for the docs. /bin/bash -c "touch content/docs/mimir/_index.md && make server" can be removed once the website team updates the docker image.

Which issue(s) this PR fixes:

Fixes https://github.com/grafana/mimir-squad/issues/523

[jdbaldry]

We already have a docs target in the top-level Makefile included from docs.mk.

For consistency with other repositories, I suppose I should move that Makefile into the docs/ directory.

Would you be able to make the changes in docs.mk or explain what additional step we need to take to make sure that the table of contents works as expected; is it the creation of the _index.md , is it the use of make server, or both?

[robbymilo]

Would you be able to ... explain what additional step we need to take to make sure that the table of contents works as expected; is it the creation of the _index.md , is it the use of make server, or both?

The extra command is temporary as there is no _index.md for mimir in the docker image, which the menu template relies on. We need make server here as the default command is now overridden. The website team will update the image next week, and then this can be removed.

[jdbaldry]

Gotcha! Just confirmed locally that this works. Would you like me to incorporate these changes into docs.mk (I can then also move it to the /docs subdirectory too)?

[robbymilo]

I am just now realizing there is a docs.mk. In my opinion we should be consistent company-wide, as this is the first repo I've seen where you don't cd into the docs directory. I'm not the end user here, so I'll defer to the mimir or docs team.

[jdbaldry]

Yeah I think it's worth moving it so other can find it easier. We can also include it in the top-level Makefile too without any fuss. I'll open up a PR, two ticks.

[jdbaldry]

Closing as #1043 resolved this.