Timeline for Warlords of Documentation: A Proposed Expansion of Stack Overflow
Current License: CC BY-SA 3.0
14 events
when toggle format | what | by | license | comment | |
---|---|---|---|---|---|
Mar 20, 2017 at 9:34 | history | edited | CommunityBot |
replaced http://meta.stackoverflow.com/ with https://meta.stackoverflow.com/
|
|
Sep 7, 2015 at 16:39 | comment | added | bully | Language. Each language is a silo, totally split off from the others. I'm not sure if I agree here. What if we need to have some examples / documentation on how to wire different technologies together? Or in general for some integrational stuff. From my opinion, especially on this topic some good, well-funded examples would make sense as even with good official 'onboard' documentation for the single systems / silos, the wiring gets complicated pretty fast. Plus, this is a field where experience is very valuable. With silos, we could not benefit from that experience though SO user have it. | |
Sep 1, 2015 at 16:02 | comment | added | Kevin Montrose | @JoDouglass We'll have to triangulate on the rules, since we just don't know enough believe anything we say now will last. I don't have my heart set on any particular approach, just a bunch of ideas for things that are worth exploring. A hard Q&A count does have problems though, I agree. What I'm imaging when a say "critical mass of Q&A" is some amalgamation of all Q&A activity along with a time window; so questions, answers, voting, # of users, total reputation, etc. within some period of time. | |
Sep 1, 2015 at 15:56 | comment | added | Jo Douglass | @KevinMontrose As far as which tags get documentation - I hope it's not ultimately related to Q&A count. As I've said in a comment elsewhere, there are quiet tags which I suspect suffer from the fact that SO doesn't look like a good source of information for that tag, so people don't sign up and ask questions about them - documentation could drive usage. There are quiet tags that suffer from a high percentage of fairly similar "newbie" type questions which it'd be great to pre-empt with documentation. Completely get focusing on high activity tags first, though. Thanks for the replies! | |
Sep 1, 2015 at 15:49 | comment | added | Jo Douglass | @KevinMontrose That's fair, but I hope an open mind is kept during beta and after go-live as feedback is received. I definitely click through tree views and the like in documentation elsewhere, but maybe I wouldn't if good quality "related topics" links were available. I am still concerned about information being duplicated (and potentially inconsistent) in multiple Topics. | |
Sep 1, 2015 at 15:37 | comment | added | Kevin Montrose | @JoDouglass I think there's a meta-point here which is that "hierarchies are never perfect, and the way people navigate these imperfect hierarchies is through Google searches." If this is true (and I really believe it is) then burning effort on hierarchies is something of a waste; we're best going with the simple things that have immediate use. | |
Sep 1, 2015 at 15:35 | comment | added | Kevin Montrose | @JoDouglass something I could have been clearer about is that not all [tag]s will get documentation, there will be a "switch" (exact details TBD, maybe something Area 51-ish; maybe just a critical mass of Q&A). Things like [database-design] probably don't get docs, that content is better in DB-specific tags. I don't really think listing Topics is a terribly interesting feature, because there will be so many of them. Much more interesting is mining cross-links for relatedness, bubbling that up in search (and perhaps some navigation...) because the sets are much smaller. | |
Sep 1, 2015 at 11:58 | comment | added | Jo Douglass | (Continued from above.) For instance, if the .NET tag were set as the parent of C# and VB.NET, then going to the .NET documentation would display the topics associated with .NET itself, but with the ability to get to the C# and VB.ET specific documentation as subcategories. Going directly to the C# documentation would just take you straight to the main C# documentation page. | |
Sep 1, 2015 at 11:55 | comment | added | Jo Douglass | There are some tags I think 1-to-1 would be really bad for. Simply as an example, we have database, database-design, database-schema, data-modeling, and relational-database. There is bound to be overlap. We need a structure which ensures we don't have competing topics related to different tags, resulting in some tags being incomplete, or contradictory information between related tags. Maybe topics could be associated with multiple tags? Or both tags and the documentation area could reflect hierarchies? | |
Aug 31, 2015 at 20:38 | history | edited | Frank | CC BY-SA 3.0 |
added 363 characters in body
|
Aug 31, 2015 at 20:24 | comment | added | Kevin Montrose | Structure is tricky, I prefer a 1-to-1 with tags (but requiring some census to create an area off of tag) because then we've got an easy way to "transfer" between Q&A. Not so much moving text around, but reputation, badges, search, and linking all have clear relationships. Language > area also breaks down around .NET (many languages, single area), Java (many languages, many areas), iOS (two languages, single area). | |
Aug 31, 2015 at 20:21 | comment | added | Kevin Montrose | For scope - we're imaging most things allowed in existing docs would also be, basically anything that can fit in a single page. Not just function/class/module level, but mini-tutorial (single page) and things like "Getting Started". | |
Aug 31, 2015 at 20:06 | comment | added | joran | My only immediate positive thought relative to R was that it might be a nice place to expand on the Examples section in the existing specific R documentation pages, which can sometimes be pretty limited. | |
Aug 31, 2015 at 19:57 | history | answered | Frank | CC BY-SA 3.0 |