On 2014.02.04. 4:01, Warren Block wrote:
On Mon, 3 Feb 2014, Dru Lavigne wrote:
This section:
23.4. Updating the Documentation Set
really belongs (and is already mostly duplicated in):
http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/overview.html#overview-doc
Any objections to me doing the following?
1. remove "23.4. Updating the Documentation Set" from the Handbook,
replacing it with a NOTE in the updating section that docs can either
be updated during an OS upgrade or, at any other time, by following
the instructions in the FDP overview (with link)
2. make sure that any points covered by 23.4 and currently missing
from the FDP overview are added to the FDP overview
Don't we have doc ports specifically for users to keep a current
version of the documentation on their system? Upgrading a port is
simpler for an end user than an svn checkout, there's less overhead,
and we would not have to expose them to developer instructions.
I also think that should be still documented in the Handbook. It is a
relevant information from an end-user perspective how to obtain the
already rendered versions of other kind of documentation. And imo, it
should be treated in the introduction or somewhere in the beginning.
Gabor
_______________________________________________
[email protected] mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "[email protected]"
