Linux kernel changes on the release notes
Karsten Wade
kwade at redhat.com
Wed Mar 8 18:54:15 UTC 2006
On Wed, 2006-03-08 at 14:30 +0530, Rahul Sundaram wrote:
> Hi
>
> The network section on the release notes
> (http://fedoraproject.org/wiki/Docs/Beats/Networking) documents some of
> the major changes between kernel revisions but these are already nicely
> documented at http://wiki.kernelnewbies.org/LinuxChanges. I added this
> link to the relevant section already but maybe we should not duplicate
> this information within the release notes unnecessarily?
It is an interesting question that dovetails into something that I was
thinking about this morning:
How online can we go with our release notes? How far _should_ we go?
On-system documentation is very valuable, that is, manual and info
pages. What role do the release notes play in on-system documentation?
Can/should they be useful in a non-network situation?
The release notes can give a location to list bugs fixed, bugs known,
and latest information that could not make it into package
documentation. Should it do that?
A release notes is a snapshot in time of documentation that is about a
snapshot in time of code development. It seems to me a natural place to
duplicate all manner of external content that pertains to that snapshot.
Package change lists, bug reports, and content pulls from various
location can be automated.
- Karsten
--
Karsten Wade, RHCE * Sr. Tech Writer * http://people.redhat.com/kwade/
gpg fingerprint: 2680 DBFD D968 3141 0115 5F1B D992 0E06 AD0E 0C41
Content Services Fedora Documentation Project
http://www.redhat.com/docs http://fedoraproject.org/wiki/DocsProject
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 189 bytes
Desc: This is a digitally signed message part
URL: <http://listman.redhat.com/archives/fedora-docs-list/attachments/20060308/7187a938/attachment.sig>
More information about the fedora-docs-list
mailing list