Fedora Release Notes

[Ian Weller]

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 at 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
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 197 bytes
Desc: not available
URL: <http://listman.redhat.com/archives/fedora-devel-list/attachments/20090201/b4fa1575/attachment.sig>