Things can always be made better - so why not refocus and clean up the tag? ## Tag Wiki Since we expect questions on StackOverflow to be (closely) related to programming, and we have other StackExchange sites that can address non-programming aspects of documentation, I propose that the subject of [tag:documentation] on SO be defined around the parts of it that touch code: >Use the [tag:documentation] tag for questions related to self-documenting code and documentation generators. To that end, [the tag wiki has been updated][1]. ## Wiki Excerpt Let's assert that users pay attention to the wiki excerpts that pop up when they're adding tags to questions. Given that, then, an excerpt that discourages the common off-topic questions would be an improvement. [How about this][2]? > 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. ## Improve or close off-topic questions If a dedicated editor can improve a question to make it on-topic and thus preserve any helpful answers, then by all means do so. If a question is off-topic, and there is no value in the answers, close it. To review any [tag:documentation] questions that have close votes on them, you could filter the Close-Vote Review Tool, [like this][3]. ## Queries for likely off-topic questions Given that the most obvious off-topic questions are those looking for tools or links to on-line documentation, the following queries are useful for identifying them for improvement or closure. - [tagged with \[documentation\] search options **title tool questions only not closed**][4] - [containing "list of" tagged with \[documentation\] search options **not closed**][5] - [tagged with \[documentation\] search options **title documentation questions only not closed**][6] - [containing "link to" tagged with \[documentation\] search options **not closed**][6] - [tagged with \[documentation\] search options **body documentation for not closed**][7] (There's LOTS of filth down 'ere, Dennis!) - [containing download tagged with \[documentation\] search options **not closed**][8] - [tagged with \[github\] \[documentation\] search options **not closed**][9] (Many other tag combinations are commenting on or simply mentioning documentation for something. Need to be retagged.) [1]: https://stackoverflow.com/revisions/5120458/4 [2]: https://stackoverflow.com/revisions/5120459/5 [3]: https://stackoverflow.com/review/close?filter-tags=%5Bdocumentation%5D [4]: https://stackoverflow.com/search?q=%5Bdocumentation%5D%20closed%3A0%20title%3Atool [5]: https://stackoverflow.com/search?q=%5Bdocumentation%5D%20closed%3A0%20%22list%20of%22 [6]: https://stackoverflow.com/search?q=%5Bdocumentation%5D%20closed%3A0%20title%3Adocumentation [7]: https://stackoverflow.com/search?page=3&tab=Relevance&q=%5Bdocumentation%5D%20closed%3A0%20body%3A%22documentation%20for%22 [8]: https://stackoverflow.com/search?q=%5Bdocumentation%5D%20download%20closed%3A0 [9]: https://stackoverflow.com/search?q=%5Bgithub%5D%20%5Bdocumentation%5D%20closed%3A0