Since we started building a ton of examples in Documentation, will there be a close reason in the future when the question is clearly covered in one of the doc examples?
-
8Or maybe we could close as a duplicate of a doc example– NobodyNadaCommented Jul 21, 2016 at 17:44
-
4Before we can even begin talk about closing as documented, we first need to let people search documentation.– Nicol BolasCommented Jul 21, 2016 at 20:09
-
23Hehe, that's the closest thing to an "RTFM" close reason - of course I'm all for it :)– Dev-iLCommented Jul 21, 2016 at 20:10
-
Every time I read "Documentation" here at SO, I understand "Examples" or "Recipes" i.e. specific working sandbox toy solutions catalogued in a meaningfully, practically proven ordered way and that can be indexed into robustly - so I would consider it (if it succeeds) more a positive example answer proxy that can be linked to in a more stable way.– DilettantCommented Jan 4, 2017 at 11:05
-
I thought that this is a good idea - it was point 4 in my answer here :-) (Well, docs as answers rather than close reasons, but potato potahto).– Rob GrantCommented Jan 15, 2017 at 16:51
2 Answers
Well, that'd be... Really nice, wouldn't it? Pick an example that does exactly what the asker's asking how to do, close, done.
Truth is, it's a bit premature to tell if that's a good idea or not. Nice thing is, we're tracking links to docs from answers, so we'll be able to get some reasonable estimates for this on down the road a bit. If nothing else, maybe we can encourage folks to use docs instead of writing the same damn answer every time they see a question. That'd be almost as good, really.
Time will tell...
-
3
-
5"maybe we can encourage folks to use docs instead of writing the same damn answer every time they see a question" - if that would actually happen, I would be sooo happy. Commented Jul 21, 2016 at 17:49
-
35"Status INSUFFICIENT DATA FOR MEANINGFUL ANSWER", @NathanOliver– Shog9Commented Jul 21, 2016 at 17:50
-
3If we did this, then it might make sense to migrate some canonical answers to documentation too. Commented Jul 21, 2016 at 20:36
-
That would mean all our carefully curated content will be moved to or closed by docs.– PeeHaaCommented Jul 21, 2016 at 20:53
-
2Only if folks are idiots about it, @PeeHaa. Why get rid of a good dup-target with tons of inbound links? Plenty of stuff that gets asked a lot without having a good canonical though, and lots of... uh, friendly disagreement... as to how canonicals should be created.– Shog9Commented Jul 21, 2016 at 20:55
-
-
2Although the idiots part is true we have seen a lot of duplication already as it is while everybody jumps on the free rep.– PeeHaaCommented Jul 21, 2016 at 21:05
-
-
-
-
@Shog9. Re: "Status INSUFFICIENT DATA FOR MEANINGFUL ANSWER". Has enough data been accumulated to shed more light on how we should refer to / defer to Documentation when dealing with Q&A?– markECommented Sep 22, 2016 at 17:41
-
1Not really, @markE - I'd suggest we revisit this in maybe 6 months, ideally after there's been a public data dump with Docs data.– Shog9Commented Sep 23, 2016 at 3:27
-
1@Shog9 Roughly 8 months later, any ETA on that data dump or revisit?– TylerHCommented May 17, 2017 at 20:26
Documentation shouldn't become a substitute / replacement for good quality answers. There are plenty of good questions / Answers that are answered by referencing existing documentation. The answer to the question will explain the context of that documentation in the case the user is asking. (sometimes)
If the question is a bad question, it should be closed for existing reasons. If someone asks a good question and they haven't found / understood / something the documentation page, then they should get an answer, that points to the documentation page. This helps in coming searchers in future to understand the context of the question, and the answer that is given, complete with a link to documentation for them to find further details.
Essentially we're suggesting having an RTFM close reason, its just that the manual has moved internally to SO.
(edited /rewritten to clarify)
-
3So if you ask a bad question then it would be okay? Anyways isn't this kinda what we do though with dupe closure already? We don't give the user and exact tailored answer but we give the a answer that when understood and modified to their exact conditions works for them. Commented Jul 21, 2016 at 17:51
-
1if it is a bad question, we already have plenty of reasons to close it. One of the most frustrating features of MSDN forums (for me) was that you would get links to documentation that didn't even come barely close to answering what you were asking. It was just vaguely in the same ball park. Being able to close a question for the same reason would just be frustrating. Commented Jul 21, 2016 at 17:52
-
2Why should a fine question be closed? Let's get real here - way more questions should get closed and I have seen almost zero closed questions that shouldn't. Commented Jul 21, 2016 at 17:57
-
@juergend I don't think good questions (fine? autocorrect?) should be closed, I think we have plenty of reasons to close bad questions, I don't think a 'covered in docs' adds anything to SO (and very strongly detracts) Commented Jul 21, 2016 at 18:18
-
2Absolutely, "I read 'how to filter a list' [on Docs](link-to-doc) and I don't understand it because blah blah blah." is not closable as a duplicate. On the other hand "How do I filter a list?" should be closable as a duplicate. The latter is readily transformed into the latter, but until it is it should be, and stay, closed.– jscsCommented Jul 21, 2016 at 19:05
-
2The difference with RTFM is that this points out the exact part of the manual to read. How is closing as duplicate of a documentation item with a canonical example of the code required worse than closing as duplicate of someone else's question? Commented Jul 21, 2016 at 20:02
-
12@MartinSmith: "The difference with RTFM is that this points out the exact part of the manual to read." Not only that, our "manual" entries are designed to be fairly standalone. Commented Jul 21, 2016 at 20:11