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

How about if you just give them the man page for "find" and the /? page for "dir" and see who can get the command correct first?



Looks like "find" is yet another command with the Examples section at the very bottom. I suppose that's the convention or something, but sometimes I do run into a man page with the examples at the top, and it takes a lot of effort not to jump up and shout "Thank you!" loud enough for the author to hear me.

The brain is a powerful inference engine. A few well-chosen examples can teach 95% of normal people 95% of what they need to know (numbers pulled out of my butt, 2016). Put good examples at the top and marvel at how many more people actually seem like they RTFM.




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

Search: