Timeline for Tearing Down the Structure of Documentation
Current License: CC BY-SA 3.0
17 events
when toggle format | what | by | license | comment | |
---|---|---|---|---|---|
Aug 25, 2019 at 15:20 | comment | added | jpmc26 | @KubaOber The common term for it would actually just be "heart attacks." I have never heard anyone use it in non-medical conversation. | |
Aug 25, 2019 at 15:14 | comment | added | Kuba hasn't forgotten Monica | @jpmc26 It's a word whose meaning highly depends on context. Here, I used it as a short for coronary thrombosis. It's a rather popular use of the term in the U.S., but perhaps not so elsewhere - I apologize for any confusion :) | |
May 28, 2017 at 1:18 | comment | added | user3743222 | I do agree that there are several types of documentation, and that all are needed, and that some have a greater need for improvement, in content, scope, searchability, etc. And giving the size of the how-to/cookbook industry, and proliferation of how-to medium articles, I believe that there is a clear value for the programmer for cookbook/how-to examples. It is also clear that any how-to example, is an answer to an how-to question, hence the overlapping with Q&A. STILL, it is worth identifying and (re)packaging key most-useful recipes. So there is a need/pitch. Now let's see the product. | |
May 26, 2017 at 23:36 | comment | added | jpmc26 | "Flagging questions as dupes that are better covered by a comprehensive Q&A pair seems to cause coronaries" ...It causes arteries and veins? | |
May 22, 2017 at 9:25 | comment | added | SGR | @NicolBolas I'm not disputing the quality of the material, I'm simply stating that what would be an off-topic question at it's very core, regardless of the quality of it on Q&A could make a good example in detail on Documentation, at least to my reading. Just because Documentation has a wider scope of what would be "on-topic" doesn't mean it's letting any old crap in by default. The actual quality of Documentation is in theory up to the contributors. | |
May 20, 2017 at 3:47 | comment | added | user207421 | @JonEricson The 'original pitch' has been critiqued and refuted point by point and had its assumptions and inferences demolished so many times that it most certainly isn't relevant, and never was. This is the basic problem here, not structure. There is no logical basis for this project, and never has been. | |
May 19, 2017 at 17:24 | comment | added | Nicol Bolas |
@SGR: We've seen many topics just like that. And they are, uniformly, garbage in terms of quality. Every keyword, operator, or whatever topic on Docs.SO is an unformed mess of stuff. It's not something you would ever read. And as reference material, it's terrible. Seeing how to use the else keyword doesn't tell you much about it.
|
|
May 19, 2017 at 13:02 | comment | added | Kuba hasn't forgotten Monica |
I think that all we need is a [documentation] tag with a policy that such questions are broader and are meant only for documentation-style work. From what I gather thus far, documentation is: a system of answering broad questions without stating them first. As any writer knows, a problem/question statement positively influences the quality, scope and focus of any "answers" written to it, I claim that question-less documentation is not how anyone should ever write any documentation anyway. The "question" may be more of a statement of purpose/goal/outline, but it needs done.
|
|
May 19, 2017 at 12:58 | history | edited | Kuba hasn't forgotten Monica | CC BY-SA 3.0 |
added 19 characters in body
|
May 19, 2017 at 8:39 | comment | added | SGR | @NicolBolas In my opinion, say we had a question on SO "What are all the Arithmetic operators in PHP and how do I use them?". That'd be closed the instant it's asked. However, it might have been a good example on Documentation, under something like "Arithmetic Operators in PHP". | |
May 18, 2017 at 23:30 | comment | added | Suragch | I often add Q&A pairs. I can usually expect my questions to get several downvotes at first by those who patrol the new questions (probably for being too broad) (example - please don't downvote it back below 0 again), but over time they go positive after getting upvoted by the general community. My answers would probably fit better in a documentation format. I tried moving some of them there, but I quit after at least one was deleted because it was competing with another earlier example. When documentation is more stable I may go back to it. | |
May 18, 2017 at 21:56 | comment | added | Jon Ericson Staff | @NicolBolas: Not at all. Documentation won't have questions. | |
May 18, 2017 at 21:56 | comment | added | Nicol Bolas | @JonEricson: You seem to be saying that Docs.SO is just Q&A, but we allow crap questions. And therefore, you're agreeing with Kuba that they're the same. | |
May 18, 2017 at 21:49 | comment | added | Jon Ericson Staff | @NicolBolas: I'm pretty sure any example I give I could also get on Q&A with a little bit of effort. But if someone with no SO experience were to ask the same question (in their own words) they would be downvoted pretty quick. Keep it up? Question banned. Maybe that's the ideal solution. Or maybe, just maybe we can do something different. | |
May 18, 2017 at 21:28 | comment | added | Nicol Bolas | @JonEricson: "Not many people self-answer questions and some questions are closed as too broad. That means critical elements of programming knowledge have no place on Stack Overflow Q&A." I don't agree that A leads to B here. Can you provide an example of a Docs.SO example that shows "critical elements of programming knowledge" which could not have a sufficiently narrow question that generates that as an answer? | |
May 18, 2017 at 21:26 | comment | added | Jon Ericson Staff | The original pitch is still relevant. Not many people self-answer questions and some questions are closed as too broad. That means critical elements of programming knowledge have no place on Stack Overflow Q&A. I think Q&A does serve as "shadow documentation" for a lot of technologies. It's better than the old system where knowledge was passed down in person or on unstructured forums. But maybe we can do better. If you want to help us find out, we are asking for your help. | |
May 18, 2017 at 21:09 | history | answered | Kuba hasn't forgotten Monica | CC BY-SA 3.0 |