NAME
man - manual page conventions
DESCRIPTION
DESCRIPTION
Start with one line that describes what the subject is. Prefer precise/intentional vs vague and left to interpretation.
The page, overall, should answer how to install, use, operate, either through relevant links in SOURCE, FILES, SEE ALSO, or directly within the DESCRIPTION if the information doesn't exist anywhere else
The page may include, in the DESCRIPTION, relevant information about the subject such as design notes, context, and other useful information
FILES
Lists files directly used. Each file gets its own line, each line has a path and an optional description.
SOURCE
One line per source. Each file gets its own line, each line has a path and an optional description.
SEE ALSO
Links are comma separated.
It's okay to duplicate a link that has already been shared in the DESCRIPTION.