I was just about to make a new post to propose "we should start using tags like language-common-problems
to organize canonicals for reference".
-faq
is much shorter than -common-problems
and I'm glad I accidentally stumbled on this post first.
I wish to wholeheartedly endorse the continued existence of c++-faq and r-faq, and the creation of analogous tags for other languages (especially python-faq, for personal reasons that will become obvious below). I will first consider the existing standards for tags, and then attempt to anticipate some objections.
Burnination standards:
- Does it describe the contents of the questions to which it is applied? Is it unambiguous?
It's arguably meta and subjective, but it's easily valuable enough to make up for that. The purpose of the tag is clear: to make duplicate closures easier. Right now, if I want a curated list of reference questions for the problems I keep seeing come up, I need to: 1) curate it myself by using bookmarks (that I also use for other things); 2) have become aware of the advanced search features; 3) put the clunky magic phrase inbookmarks:mine
in the search bar. Either that, or rely on an external site (e.g. for Python, that's https://sopython.com/canon/).
- Is the concept described even on-topic for the site?
There is nothing that could possibly be more on topic for the site than "a question about programming in a specific language which is frequently asked".
- Does the tag add any meaningful information to the post?
Yes; as stated, it facilitates searching for duplicates. It also signals that the question and answers cover (possibly after editing) a broader concept, rather than having been aimed at helping fix OP's problem.
- Does it mean the same thing in all common contexts?
I can't fathom any room for ambiguity.
Other possible objections:
- Why not just use the tag wiki?
First off, tag wikis are incredibly undiscoverable. I have been on the site 11 years, am a regular python dupe-hammer-wielder - and was genuinely surprised today to find out about the excellent content in the Python tag wiki.
Second: tag wikis have to cover a lot of other material. Pointing someone with a common question in there is asking them to drown in things unrelated to their question. Perhaps it will be better for the beginner programmer in the long run, but it's certainly nowhere near as courteous as a duplicate closure.
Oh, you meant, why not use it to find the duplicate closure links? First off, I cannot put the equivalent of intagwikifor:python
into the search box. Second, that excellent tag wiki, again, has to cover a lot of other material. In the Python case, there are (as of writing this) 18 links in the FAQ section, and (assuming there aren't any inline links) 129 other links.
Even offsite lists often don't have what I want. The SOPython canon I mentioned above has only 134 entries. Plus it's off-site, plus I have to click through those entries after searching them and hopefully find a useful canonical within the site's own wrapping FAQ text.
A -faq
tag is a much more scalable solution, in every way.
- But it's a meta taaaaaag!
Tags like this clearly could stand on their own, for the specific reason that they incorporate the language name. While I personally would leave the python tag on a question that I marked as python-faq, removing it wouldn't make the tagging useless - it would only deprive people searching for [python]
of results.
- Aren't you just sorting by difficulty level or quality?
This is clearly different from tagging the question according to "difficulty level" or similar. Something like e.g. "Least Astonishment" and the Mutable Default Argument is a somewhat subtle point, and the underlying cause is material that tutorials and documentation don't cover very well (even if they should). It has, however, also been extremely useful as a dupe target.
It's also different from tagging the question according to quality, although of course FAQ entries should be among the highest quality on the site. The motivation is not to reward either the question itself, or the asker; the motivation is to get dupes closed.
- Aren't you just sorting by popularity/comment score? The site search can already do that.
I have several rebuttals here.
"Frequently asked questions" doesn't necessarily mean the most frequently asked. It is an established format for conveying vital, fundamental (not the same thing as "basic") information to learners. Many "FAQ"s on the rest of the internet have somewhat contrived questions (How often do C++ programmers actually ask about the similarities and differences between private
inheritance and composition? I would think that if the topic comes up at all, "why would anyone ever use private
inheritance?" is a much more likely starting point). Even when the questions sound "natural", they're focused on a) questions that help with debugging; b) questions that solve a practical problem; and c) questions that build a superior mental model of the language. On the other hand, programmers wonder about esoteric details all the time. (The top questions for python are actually all pretty good from what I can make out; but the voting grossly overstates their importance.)
The site search only gives me a top-N list of questions in the tag if I explicitly search and then manually look at the first N results. That might be useful for, say, studying a programming language, but the tag wiki has the advantage of being curated. It's also not useful for closing duplicates, which is the obvious reason for maintaining such a tag.
There's a massive age bias in question and answer scores. A lot of the oldest questions are obsolete (especially for Python, there are questions specific to now-obviated 2.x behavior, and they aren't all given a version-specific tag), and a lot of the oldest questions are outdated (new, updated ones get buried because of the score, no matter how good they are; updates to older ones are not applied consistently).
Deliberately written FAQ targets in 2022 have to start at zero and compete with all that. They're also, evidently, vitally necessary in many cases. The problem with FAQ material is that, a lot of the time, nobody who actually has the problem, has the skill required to write the question properly.
Popularity is also a positive feedback loop: popular questions get more exposure, through site and external search, and thus have more opportunity to gain even more upvotes.
- Even among the oldest questions, there are hidden gems - questions with wide applicability that cover common misconceptions, but didn't become very popular. This one and this one, for example, are below +100.
[r] wide long
puts the very common wide-to-long dupe fourth, after a -1 question;[r-faq] wide long
puts it in the top two, as it should be. Googling or going to another website (the tag info page; a github repo, etc.) is slower. I'm theoretically ok with faq tags going away, but only if search result relevance improves dramatically.