Timeline for Documentation doesn't look good right now
Current License: CC BY-SA 3.0
8 events
when toggle format | what | by | license | comment | |
---|---|---|---|---|---|
Jul 25, 2016 at 14:38 | comment | added | TylerH | I agree; unfortunately the "elevator pitch" was previously shot down by staff when I and others brought it up during private beta and before. Some staff have mentioned being open to adding it or at least moving Remarks to the top as a solution. | |
Jul 25, 2016 at 14:03 | comment | added | Lorenzo Dematté | Like it is now, most of the people coming in for learning something cannot understand what is going on. They will not learn C#. Instead, they will just find the "correct" topic (say, how to read a file), copy paste, job done. Dispose? pff, another topic. Encoding? Async? Streams? | |
Jul 25, 2016 at 14:00 | comment | added | Lorenzo Dematté | "Elevator pitch" is extremely needed. It is all about examples, OK, but what if I cannot figure out what the examples are for? | |
Jul 25, 2016 at 10:44 | comment | added | TarkaDaal | I'd upvote this a hundred times if I could. I thought it was just me. | |
Jul 24, 2016 at 5:40 | comment | added | Justin | Exactly. This is why I like Java's documentation, except for their lack of examples (but I find that the oracle tutorials work fine for that when necessary) | |
Jul 24, 2016 at 4:20 | comment | added | castletheperson | I agree with the elevator pitch idea 100%. There just needs to be an incentive to fill out the non-example parts of the documentation, because currently all the rep is in the examples, and it's screwing up the format. | |
Jul 24, 2016 at 1:32 | comment | added | j08691 | Agreed. I've always felt that PHP does a decent job with their docs. Succinct, simple, to the point. The examples could use a bit of help, but SO's documentation is essentially the opposite. | |
Jul 23, 2016 at 8:24 | history | answered | Brock Adams | CC BY-SA 3.0 |