Skip to main content
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