23

I stumbled across the tag and in conjunction with it the tag. I'm including the second tag here as well, as it is mentioned in the tag description (emphasis mine):

A user manual is also known as user guide. It is a technical communication document intended to give assistance to people using a particular system or software.

Also, doesn't have a tag description. It ironically only says

The user-guide tag has no usage guidance.

As it stands today has only 15 questions associated with it and has only 27 questions. In total, there are 40 questions affected, with 2 questions featuring both. I don't know how to handle requests for two similar tags at once, so I'm sorry if this is not the right way to do it.

Does it describe the contents of the questions to which it is applied? and is it unambiguous?

The tags describe the content only vaguely. They appear in questions asking how to write a manual for a certain application or as a request for software suggestions regarding writing user manuals. But they're is also used when the questioner refers to the manual they've read and sometimes it doesn't have any connection to the question at all. Users seem to interpret these tags in multiple ways, so they are ambiguous.

Is the concept described even on-topic for the site?

No. Both tags are not about "a specific programming problem, a software algorithm, or software tools primarily used by programmers" and are therefore off-topic. They both describe a piece of documentation that users of a particular application can refer to when they need information about its usage.

Does the tag add any meaningful information to the post?

No. Both tags are very generic and only tell viewers that some kind of documentation is involved in their question. To me those tags describe an umbrella term which I'd put into the same category as the tag, which was burninated recently. Also, as mentioned, this tag is used in questions that are off-topic or questions that even have nothing to do with documentation.

Does it mean the same thing in all common contexts?

No. Both tags are used in questions that are concerned with documentation targeted at end-users, documentation for developers, excerpts of man pages, software for creating documentation.

All in all, I don't think that and add anything to the questions that have these tags. So both tags could be burninated without affecting much.

7
  • 4
    Most usage of both tags seems to be about creating of user manual/guide. Such usage looks similar to documentation, so I would think about making them synonyms to that tag. Well, a user manual and a user guide are specific types of the documentation, but I don't think that such specific should be expressed by tags. BTW, "Both tags are not about "a specific programming problem, a software algorithm, or software tools primarily used by programmers" and are therefore off-topic" - A tag should not be about "a specific programming problem", a question should.
    – Tsyvarev
    Oct 29, 2022 at 10:00
  • 3
    Do note that any tag with <50 questions, there is no need to ask for a formal burnination request, can you message the mods or high rep users in chat! :3
    – DialFrost
    Oct 29, 2022 at 10:13
  • 2
    "this tag is used in questions that are off-topic" - well, the community doesn't seem to think so: 66 posts with a positive score tagged [user-manual] or [user-guide], including this question (129 upvotes, no downvotes).
    – The Thonnu
    Oct 29, 2022 at 10:17
  • 2
    @TheThonnu but it adds no meaningful information to that post. Is it saying that it's asking for information from the user guide? Information that should be in the user guide? Is it saying that it's a question they encountered while reading the user guide? The other two tags add useful information, but that one does not.
    – Ryan M Mod
    Oct 29, 2022 at 10:27
  • @RyanM - maybe what's needed is a disambiguation, then. If we do that, it could add meaningful information to the post.
    – The Thonnu
    Oct 29, 2022 at 10:34
  • Take this question as an example. In this one, it does add meaningful information. Tagging it just with [android] would lower the quality of the post.
    – The Thonnu
    Oct 29, 2022 at 10:35
  • 1
    @TheThonnu I agree that it adds meaningful information to that post, though I'm not sure there are enough such posts to justify it. I put my thoughts at greater length into an answer.
    – Ryan M Mod
    Oct 29, 2022 at 10:54

2 Answers 2

13

These questions seem to fall into a few categories:

  • Questions about documentation-generation tools. These should be retagged
  • Off-topic questions asking for recommendations for software to build a user guide or other opinion-based questions about writing user guides. These should be closed.
  • Questions about information in the user guide for a piece of software. The tag doesn't really add any useful information here. (example) The tag should be removed from these.
  • Questions about creating user guides in software. (examples: 1, 2) This could be useful; however, approximately 2 questions in 10+ years doesn't seem like it warrants a tag.
  • One question about downloading a programming product's user guide. This should be tagged .

Overall, the vast majority of questions that are not about seem to be either off-topic, way too broad/opinion-based, or not meaningfully related to user guides. While I found two on-topic questions that shouldn't be using a different tag (there could be a couple I missed; I was skimming a bit), it doesn't seem to be enough to justify having a dedicated tag. If there are more questions that should be tagged this way but aren't, that could be an argument for keeping it.

1
9

There is another similar tag having > 400 questions. I think and might be made synomyms of it, but first the tag excerpt and wiki of should be improved, as it doesn't include a clear and "complete" usage guidance, it just define the term very briefly and include a link to the corresponding Wikipedia article.

Perhaps, the very first step should be to do a . Do we really need a tag for documentation as a deliverable rather than a process / tooling to generate it programmatically?

See Ryan's answer


The requirement to be about a specific programming problem is for , not for , but tags should provide meaningful information to questions and help SME find answers about a certait on-topci subject, questions answer, questions as duplicate targets, etc., so it's fine to burninate tags that aren't helpful at all according to the scope and workings of SO.

Regarding one of the comments about make these tags synonym of another, I'm don't think that these tags should be turned into synomyms of as the tag excerpt of this tag says

THIS TAG IS FOR DOCUMENT GENERATORS ONLY. Include language and/or SDE tag as well. DO NOT USE to ask for links to documentation or tools, or to critique vendor documentation.

It might be better to make them synonyms of , but IHMHO first a should be done.

Related

2
  • 1
    Making those tags synonyms is fine by me. Although not all questions I've listed above should be tagged as such. I was just under the impression that in order to use a tag in an on-topic fashion, it needs to be able to be used in an on-topic question. Hence I made the connection with the "on-topic" page. But it seems that "topic-ness" for questions and tags differ.
    – QBrute
    Oct 29, 2022 at 11:00
  • 1
    @QBrute Definitely there is a connection between the site scope and tags and something might be do with these tags. At the end, tags that are only used in off-topics questions eventually will automatically disappear when the off-topic questions be deleted.
    – Rubén
    Oct 29, 2022 at 11:41

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .