grafana/docs
Torkel Ödegaard 4f9f186575 docs: overhauled annotation docs and moved some of the data source specific annotation docs to the respective data source doc pages, closes #1111 2017-04-28 12:51:21 +02:00
..
sources docs: overhauled annotation docs and moved some of the data source specific annotation docs to the respective data source doc pages, closes #1111 2017-04-28 12:51:21 +02:00
Dockerfile docs: fixed docs title issue 2017-03-14 12:21:22 +01:00
Makefile docs: updated make file for docs to support specifying env and version 2017-04-27 12:17:22 +02:00
README.md Update building docs readme 2017-02-06 10:19:47 +01:00
VERSION docs: updated make file for docs to support specifying env and version 2017-04-27 12:17:22 +02:00
config.toml docs: minor fix 2017-03-17 19:33:31 +01:00
s3_website.json

README.md

Building The Docs

To build the docs locally, you need to have docker installed. The docs are built using a custom docker image and the mkdocs tool.

Prepare the Docker Image:

Git clone grafana/grafana.org repo. Run these commands in the root of that repo. Note that you may require sudo when running make docs-build depending on how your system's docker service is configured):

$ git clone https://github.com/grafana/grafana.org
$ cd grafana.org
$ make docs-build

Build the Documentation:

Now that the docker image has been prepared we can build the docs. Switch your working directory back to the directory this file (README.md) is in and run (possibly with sudo):

$ make docs

This command will not return control of the shell to the user. Instead the command is now running a new docker container built from the image we created in the previous step.

Open localhost:3004 to view the docs.