Timeline for Tearing Down the Structure of Documentation
Current License: CC BY-SA 3.0
8 events
when toggle format | what | by | license | comment | |
---|---|---|---|---|---|
May 26, 2017 at 23:28 | comment | added | jpmc26 | Maybe that means part of what's needed is a way to phase out obsolete stuff more effectively? It's entirely possible that you'd end up just building another SO trying to go that route, though. I dunno. It just seems like maybe, "Make it all perfect right now," isn't a winning strategy. Even if you get a standard, if it doesn't turn out to be a good one, you'll need to clean up the mess. (Hence the current situation.) | |
May 26, 2017 at 14:53 | comment | added | Nicol Bolas | @jpmc26: But there's a difference. Old questions effectively go away. Even if they're not deleted, they're barely here. They may show up on Google searches, but they're not something you see every day in the list of questions on tags. On Docs.SO, old documentation is more prominent than new documentation. We show the highest voted stuff first, which will be the oldest stuff. Docs.SO needed a standard immediately because content never ages away. SO deleted some older content, but left other older content lying around. You can't do that with Docs.SO and still have good documentation. | |
May 26, 2017 at 6:44 | comment | added | jpmc26 | Hm. I agree with the principle that a standard is needed, but I actually don't think your argument supports your conclusion. Your argument is based on the fact that SO started off kind of a mess and eventually got refined into something better. From there, you argue that we should avoid the mess entirely and get a standard now, but SO's success doesn't suggest we need a standard immediately. It suggests that, "Let a flood of crap come through and then we'll start sifting for gold," might actually be a viable strategy... | |
May 19, 2017 at 13:08 | comment | added | Kuba hasn't forgotten Monica | I think that the example you cite highlights the problem I see: lack of focus and direction. When doing any writing, technical or not, you have to have a purpose in mind, and that purpose rarely fits in what amounts to a headline. A clearly written question defines scope of the answers and helps the answer authors stay on task. Existing SO Q&A could be used to have curation topic questions with answers linking to other relevant answers and curating related content better than search results would. The SO search engine could include such related answers even if not picked up by search keywords. | |
May 19, 2017 at 3:28 | comment | added | Nathan Tuggy | As we know from SO, mature and successful rules don't have much ambiguity to them. | |
May 19, 2017 at 1:28 | history | edited | Braiam | CC BY-SA 3.0 |
added 1 character in body
|
May 18, 2017 at 21:35 | comment | added | Jon Ericson Staff | My point wasn't that the Java Arrays topic was particularly good, but that, for some reason, the Java Twitter channel mentioned it. I agree that topic is a mess and so we're going to find some way to fix it. This time we are following the early SO model you mentioned. But please let's not decide on a standard of what's a good example yet. That's the incrementalist approach we've already been burned by. | |
May 18, 2017 at 21:26 | history | answered | Nicol Bolas | CC BY-SA 3.0 |