Syncthing Docs
This repo is the source behind http://docs.syncthing.net/.
Editing
To edit the documentation you need a GitHub account. Once you have created one and logged in, you can edit any page by navigating to the corresponding file and clicking the edit (pen) icon. This will create what is called a "fork" and a "pull request", which will be approved by one of the existing documentation team members. Once you've made a contribution or two, you can be added to the documentation team and perform edits without requiring approval.
In the long run, learning to use git and running Jekyll on your computer is beneficial.
Structure
The documentation is divided into an index page (index.md) and various subsections. The sections are:
- Introductory information in
_intro. - Information for users in
_users. - Information for developers in
_dev.
Each page has what is called a "front matter", which looks something like:
---
title: Getting Started
weight: 0
---
This sets, at minimum the title of the page. There are various other attributes that can be added, the most common ones being weight (to adjust the order of pages in the index; lower number gets sorted higher up) and nav (set nav: false to have a page not be listed in the index).
The rest of the page is in Markdown format.