#10 Split vesta-intro for clarity
The vesta-intro(1) man page currently serves several
different purposes:
- It has a few sections that are introductions that
explain important concepts (configuration files,
filename interpretation).
- It has a glossary that explains Vesta terminology.
- Its "See Also" section is a listing of many other man
pages and other documents users may need to refer to.
Unfortunately, this makes makes it easy for users to
overlook some of these different pieces. (For example,
one user requested an index of the man pages, and when
I asked them why the "See Also" section in
vesta-intro(1) wasn't sufficient, they said they'd
never noticed it, even though they had looked at the
man page.)
It might be best to break up the vesta-intro page into
three different man pages: an introduction, a glossary,
and an index of other documentation.
It might also be good to add more references to more
related man pages in the definitions of different terms
in the glossary, so that it can serve as more of a
topic index as well. (Many of the glossary entries
have such references now, but not all of them.)
