Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

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.



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.


But of course, your profile lists lisp.


I beg pardon, what do you mean by that?


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.





Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: