News for hackers. Stuff that matters.
Re:WTFM - Write The Freaking Manual by brudgers on Friday September 28, 2012 @03:44PM (#4587432)
The root of this issue is that writing documentation is not something that really good hackers like to do...these days [1].

And it's damn sure not something that good writers are interested in...unless they are paid. Paying good writers to write documentation is not a core competency of the FOSS community, nor part of its ethos.[2]

[1] These days being the age of the internet and languages implementing brogrammar. People like McCarthy and Knuth wrote their own documentation to a dead tree publication standard, not a rough draft of a Wiki standard.

[2] Erlang and Go aren't going to give the world another RPG or PG writing passionately about their wonders.

Re:WTFM - Write The Freaking Manual by pnathan on Friday September 28, 2012 @03:59PM (#4587494)
One thing I've done a few times is to help out just by writing docs for open source projects.

I know it's a drag. I know it's not that much fun. But it massively - MASSIVELY - improves the project's value, especially if it's low on the totem pole.

Re:WTFM - Write The Freaking Manual by brudgers on Friday September 28, 2012 @04:18PM (#4587588)
But of course, your profile lists lisp.
Re:WTFM - Write The Freaking Manual by pnathan on Friday September 28, 2012 @07:00PM (#4588216)
I beg pardon, what do you mean by that?
Re:WTFM - Write The Freaking Manual by brudgers on Friday September 28, 2012 @10:23PM (#4588647)
Lisp has a literary tradition stronger than other languages. See Richard P. Gabriel, or Paul Graham for that matter. Python and Cpp may have polemics, but none as useful as Let Over Lambda.
Re:WTFM - Write The Freaking Manual by trhtrsh on Friday September 28, 2012 @06:55PM (#4588198)