Hacker News new | ask | show | jobs
by tomcam 2637 days ago
> I’m extremely rarely in a situation where the official documentation isn’t monumentally better than every other option.

Man, opposite experience here. I will cheerfully admit to being way less smart than most HN users, but I find that official documentation almost always lacks egregiously in example code, and also in overview material that gives me a 30,000’ view of the product. So often documentation seems assume that I’m already familiar with the product, when sometimes I’m dropped in for some external reason and just want to get a job done without being an expert.

1 comments

I don’t think it has anything to do with intelligence, I think it has to do with experience.

Documentation can take some getting used to, and like I said, sometimes it really sucks, but I’ve found it to be worthwhile.

I mean technically you can probably google solve how to handle a bitmap in C, but that won’t teach you how the bitmap format works, so the next time you need to do it again, you’ll probably have to turn to google again. Where as I still have a pretty good idea on what to do, even though it’s been a decade since I touched C and even longer since I played around with bitmaps.

Don’t get me wrong, I say these things, not because I think I’m smarter than anyone, but because I forget everything I quick solve through google programming myself.