[CentOS-docs] a general suggestion for all of the doc pages
Robert P. J. Day
rpjday at crashcourse.ca
Thu Oct 7 08:29:23 EDT 2010
generalizing somewhat from my earlier note about the "securing SSH"
i don't know what level of intro a page like that should have but when
i've presented things like this to classes i've taught, or written
short online tutorials, the very first thing i document are the
in this case, the first section might be something as simple as
showing the output from:
$ rpm -qa "openssh*"
and, given the list of packages, a one-line description of what it's
for, which ones are necessary, and which ones simply add extra
and after that, i typically list every important file and directory
that will come into play at some point, again with a short
so for ssh, i would list the packages:
* openssh-askpass [optional]
then list what the reader will eventually have to work with:
once the intro covers that sort of thing and maps out the terrain,
every subsequent section is almost trivial. i'm just saying that that
approach has worked very well for me.
Robert P. J. Day Waterloo, Ontario, CANADA
More information about the CentOS-docs