Proposed tag wiki for "Documentation"

documentation.md

Excerpt / Usage Guidance

Use for programming-related questions about code documentation generators. Include language and/or SDE tag as well. DO NOT USE to ask for links to documentation or tools.

Tag info

Use the [tag:documentation] tag for questions related to self-documenting code and documentation generators.

Basic definitions

• Software documentation is written text or illustration that accompanies computer software or is embedded in the source code. It either explains how it operates or how to use it, and may mean different things to people in different roles.^Wikipedia

• A documentation generator is a programming tool that generates software documentation intended for programmers or end users, or both, from a set of specially commented source code files, and in some cases, binary files.^Wikipedia

Related tags

Possible synonyms:

• [tag:document-generation] - Synonymous with [tag:documentation]
• [tag:code-documentation] - Documentation within code to explain its function and use.
• [tag:manual] - as in "User's Manual"

Substitute these more specific tags for [tag:documentation] where possible:

• [tag:javadoc] - Documentation generation tool for [tag:java].
• [tag:doxygen] - Multi-language documentation generation tool.
• [tag:python-sphinx] - Tool for [tag:python] documentation generation, adaptable to other languages.
• [tag:jsdoc], [tag:jsdoc3] - Documentation generation tools for [tag:javascript].
• [tag:rd], [tag:roxygen2] - Documentation generation tools for [tag:r].
• [tag:xml-documentation] - XML documentation tagging for [tag:c##].
• [tag:springfox] - A suite of java libraries for automating the generation of machine and human readable specifications for JSON APIs written using the [tag:spring] framework.
• [tag:yard] - Documentation generation tool for [tag:ruby].
• [tag:haddock] - Documentation generation tool for [tag:haskell].
• [tag:phpdocumentor2] - Documentation generation tool for [tag:php].
• [tag:rustdoc] - Documentation generation tool for [tag:rust].
• [tag:kotlin-dokka] - Documentation generation tool for [tag:kotlin].

"Documentation" topics on other SE sites

Questions about how documentation fits within the software development process are off-topic on StackOverflow, but are on-topic on Software Engineering.

SE.Writers has tags for Technical Writing, API Documentation and Software Tools, with a focus on the craft of professional writing.

Useful links

• Getting started? See: Google - How to write user documentation.
• Looking for a tool? See: Wikipedia - Comparison of Documentation Generators.
• Wondering about recommended styles? See: Google - Style guides.

Off-Topic Questions

Remember that the following types of questions are off-topic, and subject to being closed and deleted:

• Where is the documentation for... ?
• What is the best way to document... ?
• Is there a tool to help document... ?