The documentation tag (currently 6.9k questions, 432 followers) seems to be a hangout for miscellaneous questions, many of them off-topic resource requests for links to outside documentation or documentation tools. The tag wiki consists of three links to resources about technical writing:
About documentation
1. Does it describe the contents of the questions to which it is applied? Is it unambiguous?
No, the tag is used for:
- resource requests for outside documentation (off-topic);
- resource requests for documentation tools (off-topic);
- assistance with writing general software documentation (potentially problematic, but not per se off-topic); and
- questions about specific inline documentation practices or platforms, such as jsdoc or javadoc.
2. Is the concept described even on-topic for the site?
Some of it is (jsdoc, javadoc), some of it isn't ("oh hai, i can has documentation for X system?").
3. Does the tag add any meaningful information to the post?
Possibly, but not a great deal.
- Questions about specific documentation systems such as JSDoc can get by with just a tag for the documentation system.
- Questions about general documentation practices tend to be too broad, primarily opinion-based, and/or off-topic and should be closed and deleted anyway.
- Questions about writing, editing, or understanding inline documentation could be tagged with an inline-documentation tag instead, and questions about software manuals (to the extent that such are on-topic) could be tagged software-manuals or similar.
4. Does it mean the same thing in all common contexts?
No, a question tagged java and documentation could be:
- about javadoc specifically;
- about inline documentation commenting practices in general as applied to Java;
- a request for a link to Java documentation (off-topic);
- a request for a tool recommendation for generating documentation based on Java code (off-topic); or
- a request for help with writing, understanding, or editing a software manual for a Java program or API.
This has nothing to do with the deprecated Stack Overflow Documentation platform or its associated Meta tag documentation.
inline-documentation
tag mentioned in the post is currently at zero questions....