Recommend some documentation tooling

[aanand]

Now that we have a section on documentation, it'd be good to recommend some workflows and tooling for writing and publishing docs, as @tashian suggested.

[Rubix982]

By documentation tooling, are we talking about tools such as GitHub pages, Sphinx, or ReadTheDocs? Those are common ways developers generate documentation for their code, and setup workflows that can help automate, push, and publish those pieces of documentation.

[eqn-group]

By documentation tooling, are we talking about tools such as GitHub pages, Sphinx, or ReadTheDocs? Those are common ways developers generate documentation for their code, and setup workflows that can help automate, push, and publish those pieces of documentation.

I think documentation should be distributed as text or pdf or single page html format only. hyperlinks can be used to refer from one section to another. It is preferrable to distribute your program manual along with the program itself off-line.
offline tooling must be the priority.