Hacker News new | comments | show | ask | jobs | submit login

Maybe there are partly so popular because they are not trying to be perfect? When documenting things it is not just what you include, it is also what you leave out. Sometimes you want to full syntax for some specific SQL statement, sometimes you just want a few quick examples of the alter table and then figure out the rest yourself.

For example two approaches for documenting the HTML table tag:

https://developer.mozilla.org/en-US/docs/Web/HTML/Element/ta...

http://www.w3schools.com/html/html_tables.asp




It's not such much what they left out, it's what they put focus on: quick and fast examples, which is what people mostly want (the "Try it Yourself" is also a huge plus here). If i want more detailed docs, i'm more than willing to scroll down the page.




Guidelines | FAQ | Support | API | Security | Lists | Bookmarklet | DMCA | Apply to YC | Contact

Search: