Reasons to use D
Adam D. Ruppe via Digitalmars-d
digitalmars-d at puremagic.com
Fri Sep 11 06:55:27 PDT 2015
On Friday, 11 September 2015 at 13:51:55 UTC, Adam D. Ruppe wrote:
> jQuery has burned me in the past.
BTW this is the lesson I've learned: have a couple examples for
the most common case, ready to be copy/pasted AND explicitly call
out the weird edge cases with examples learned from debugging
experience.
For example, D docs should demonstrate patterns of compiler
errors produced by common misuse. Make it so when someone
searches the vomit dmd spews, it shows them the official doc
saying "this is why it happened, what it means, and how to fix
it".
Tutorials should immediately accustom people to seeing compiler
errors by guiding them into, then back out of, various error
situations.
If only I have three months wherein I didn't have to do anything
else.... I'd actually really like to write a lot of D
documentation.
More information about the Digitalmars-d
mailing list