Timeline for Warlords of Documentation: A Proposed Expansion of Stack Overflow
Current License: CC BY-SA 3.0
12 events
when toggle format | what | by | license | comment | |
---|---|---|---|---|---|
Jun 3, 2020 at 15:29 | history | edited | CommunityBot |
Commonmark migration
|
|
May 23, 2017 at 16:57 | comment | added | NateJ | 200% this. Examples = good. Documentation = been there, done that, bought the T-shirt. | |
Mar 20, 2017 at 9:34 | history | edited | CommunityBot |
replaced http://meta.stackoverflow.com/ with https://meta.stackoverflow.com/
|
|
Dec 4, 2015 at 14:48 | comment | added | Code Jockey | I do, however think that any such system should encourage syntax to be specified. Smaller software/API projects might use such a site solely to host their documentation. If it ends up making sense, larger and larger projects might migrate to this system or (through some sort of docs/e.g API) include examples from this site in their official documentation, where they simply provide the structure and summaries that are relatively easily testable and then outsource the examples (?!?!?) | |
Dec 4, 2015 at 14:42 | comment | added | Code Jockey | I'd have to agree with this to a great extent (that "Documentation" might drive some decent contributors away) - not sure whether "Examples" is clearly the best choice, but something along those lines. I don't know - "E.G." comes to mind as having that same meaning, but being similar in tone to "Stack Overflow", "Super User", and "Server Fault" -- but in slightly different words, often what is already available from developers is basically syntax - it's a thing that's built in and testable from many IDEs even! What is most often missing is examples. | |
Sep 16, 2015 at 14:41 | comment | added | Brett | And explanations. Most of the Content Management Systems I'm specialised in developing are basically just .Net, but with a rigid framework - so any .Net dev could pick one up easily if they just had a high level overview of the concepts behind the system. And as an experienced developer I sure as hell could use a repository of examples for when I forget what class to inherit or something. | |
Sep 12, 2015 at 15:23 | comment | added | Mifeet | Exactly what I wanted to propose after reading about the idea. Examples would be the best part of documentation anyway. Documentation as I see it also implies some kind of completeness which will probably never be achieved in SO documentation. Examples do not have this connotation. | |
Sep 9, 2015 at 15:39 | comment | added | TomOnTime Staff | I agree. Nobody likes documentation (its always wrong) and nobody likes writing documentation (it sounds too much like "work"). On the other hand, everyone likes examples that work and enlighten. Examples benefit the author because it is an opportunity to show off and help others at the same time. Readers like examples because it gets to the point. | |
Sep 3, 2015 at 23:13 | comment | added | RustyTheBoyRobot | I agree. It seems pretty clear that many of the negative responses here are due to the fact that "documentation" sounds like a duplication. I think that easily searchable "objective-oriented" examples are very useful without duplicating official docs. I also think this follows the Agile principle of working software being more valuable than comprehensive documentation. | |
Sep 1, 2015 at 18:53 | comment | added | kdbanman | "If you ask most SO contributors if they’re good at writing “documentation”, they’ll say No." What evidence do you have for this? | |
Sep 1, 2015 at 15:32 | comment | added | Frank | I agree. I think they're vastly underestimating the amount of baggage that word carries. There will be very few discussions of this project on its own merits if it has to bear that burden. | |
Sep 1, 2015 at 14:48 | history | answered | sideshowbarkerMod | CC BY-SA 3.0 |