son of doc_howto
the rule is shown clearly by all the links
note: we basically follow Oreilly books
filename
dir/
program_name
command_line options
examples
see doc_format_philosophy