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

> a line at the top explaining it like you'd explain it to your parents

Another benefit of this is that in a complex environment, this helps the user check that they have the correct manual, so they don't waste their time trying to absorb it for no good purpose, realizing only some time later that it was some other manual that they wanted.



Yes, thank you. I hate reading things like:

> The whizbanginator facilitates workflows with reductive conflapitance. Here's some info about its release cycle and on call. Here are all of its configuration details, which will make you realize it does not actually solve your problems because we never told you what it was.




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

Search: