On Mon, Feb 02, 2009 at 11:10:17AM +1000, ryan lerch wrote:
Over at fedora-docs, there is ongoing discussion on the scope of the
release notes. At present, the release notes have evolved from a
document containing the relevant new features and important bug-fixes
into a document containing those items as well as an assortment of
extra basic documentation and howtos. For example, take the "Live
Image" section in the f10 notes [1], this is basically a brief
overview on Live Images (which were not a new feature in f10.)
The fedora-docs project would like to get the input from the
developers on the release notes. Should we restrict the release notes
to being a document of the new and exciting features in the newest
release, and move the older, not so fresh documentation into the
relevant guides (such as the install guide)?
Any other suggestions on the possible scope and direction of the
release notes are appreciated also!
You have to have a balance between verbosity and brevity because if a
document is too long, someone will prolong reading it.
Perhaps if the how-tos and helpful tips were all in a certain section,
the release notes would not have this problem, and also have an added
convenience of having even more helpful information.
--
Ian Weller <ianweller(a)gmail.com>
http://ianweller.org
GnuPG fingerprint: E51E 0517 7A92 70A2 4226 B050 87ED 7C97 EFA8 4A36
"Technology is a word that describes something that doesn't work yet."
~ Douglas Adams