News for hackers. Stuff that matters.
Re:Things I Learned Building The Most Powerful Language Proc... by drakaal on Friday April 19, 2013 @11:53PM (#5580044)
The challenge with the website is saying things in such a way that we don't scare off the non-technical, and still appeal to the technical.

All cards on the table, there is a lot of discussion internally about who we are writing for. The result is we get a mish-mash of copy from Engineering and Marketing.

The PDF I linked to is much better because those were targeted to Engineering managers. The website still doesn't know who it is targeting. http://www.tldrstuff.com knows its audience it sucks much less.

Re:Things I Learned Building The Most Powerful Language Proc... by jorah on Saturday April 20, 2013 @12:17AM (#5580158)
Simple, clear, and grammatically-correct writing will not intimidate non-technical users.