The documentation site for The Things Network is built with Hugo. All content is stored as Markdown files in doc/content.

Data for generated documentation like the glossary is stored in doc/data.

The Things Network Documentation development tooling uses Go and Yarn.

• Follow Go's installation guide to install Go.
• Follow Yarn's installation guide to install Yarn.

In order to build the documentation site with the right theme, you need to run make deps from time to time. This will install Yarn on Mac and Unix systems if it is not already installed.

Install dependencies and tooling to help you comply with our git style guidelines by running

$ make init

You can start a development server with live reloading by running make or make server. This command will print the address of the server.

The documentation site can be built for Github Pages by running make build.public. This will output the site to public.

The documentation site can be built for internal (offline) use by running make build.internal. This will output the site to internal.

Please see the style, branch naming, and commit guidelines in CONTRIBUTING

Run make new <path> to create a new documentation section from the template at path. For example, make new getting-started/hello will create a section in getting-started/hello.