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

I agree and appreciate that, but I don't know that it's always true. The problem is that a lot of documentation and man pages out there just aren't written well. They bury the lede and make you dig around to figure out how to do that simple thing you want to do. Googling for something and immediately finding that specific question on SO even if you could go look it up in pages of docs is a time saver.

Edit: Or perhaps the library has poor usability. I've been doing python programming for 6 years now and know the standard library like the back of my hand, but if I have to do anything reasonably complex with datetime you can bet I'll probably just look for someone on SO that has had the same problem and crib the answer.



Documentation should contain a complete reference off all options. StackOverflow rather describes... usecases.

It sounds fine to me, because the programmer can't think about all usecases, so they better be on a user-managed website.




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

Search: