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

"Documentation is like sex: when it is good, it is very, very good; and when it is bad, it is better than nothing. "

Classy.



And like sex, there are a lot more people talking about it than actually doing it ;-)

Haven't tested this app yet but the chord feature and microtonal capabilities look intriguing!


When documentation is bad it leads to wasted time, wasted money, buggy software, and angry customers.


Sex is the same if you're selling it (although buggy software will most likely not play a part)


Embarrassing. Obnoxious. Really hope the devs remove it.


Or you could just ignore it and move on. Life would be so boring if everything was so bland; corporate and HR approved


Open source is everyday getting more corporate-like. In the old times people would create open source as a hobby, nowadays they're just thinking on how this will appear on the resume.


It’s also wrong. Bad documentation is worse than no documentation because bad documentation can be intentionally misleading


I think the sentiment it was trying to get across is that many projects don't have documentation because the task of creating great documentation may seem daunting, so in a sense just saying at least have something. I'm taking it to mean it's a work in progress, but it could have been worded better, of course.


"- Yo, I don't think we should talk about this

- Come on, why not?

- People might misunderstand what we're tryin' to say, you know?"

Salt'n'Pepa


He’s Russian




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

Search: