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.
