Section II. B. 1 2 and 3 of Documentation Guide V2

[Edward Haddock]

Aloha all,
	I have the aforementioned pieces done. It is mostly links to some other
pages and could be combined at some point. Please find it copied into
this email following. Hopefully this helps. 
Mahalo,
Edward
=====
1.) The first step in joining the Fedora Documentation Project is to
join the community and engage in the discussion. Subscribe to the
fedora-docs-list, fedora-dsco-list and fedora-announce-list to keep up
to date and informed about the project and Fedora in general. The links
can be found at
https://listman.redhat.com/mailman/listinfo/fedora-docs-list,
http://www.redhat.com/mailman/listinfo/fedora-announce-list and
https://www.redhat.com/mailman/listinfo/fedora-dsco-list. After visiting
the pages and filling in the needed information an automated email
message will be sent. Choose to follow the link or respond to the email
as outlined in the instructions contained in the emails. Please note
that to be part of the Fedora Documentation Project you have to join the
fedora-docs-list.
	2.) Next, ensure that the proper tool chain is installed. The first
tools that should be installed are Yum and/or up2date. These Software
Management Utilities will ensure that all software packages are current
and aid in installing those not already installed. Both are installed by
default on Fedora Core 5 but this can be checked using rpm.
		[edward at edward ~]$ rpm -qa up2date
		up2date-4.4.23-4
		[edward at edward ~]$ rpm -qa yum
		yum-2.4.1-1.fc
	Either package will work for managing software packages.
	After that, setup Privacy Guard Software and utilities to manage the
GPG keys. Use GPG to identify yourself and authenticate your
communications, even with people you don't know. GPG allows anyone
reading a GPG-signed email to verify its authorship. In other words, GPG
allows someone to be reasonably certain that communications signed by
you actually come from you. GPG is useful because it helps prevent
mischievous third parties from polluting code or conversations by
masquerading as other entities. To participate in any part of the Fedora
Project,
	- you should have a GPG key pair, and
	- your public key must be available on pgp.mit.edu, a well-known public
keyserver.
	Some Privacy Guard Software and Management Utilities include:
		I.) GnuPG
		http://fedoraproject.org/wiki/Cryptography has a wonderful explanation
on how to install openssh and GnuPG.
		II.) Seahorse
		Seahorse is a GUI utility to manage keys. Go to
http://seahorse.sourceforge.net/ for information on installing and using
this utility.
		III.) KGpg
		KGpg is the KDE GPG key manager and can be installed via yum if not
already installed. Information and instructions can be found at
http://developer.kde.org/~kgpg/
	An editor also needs to be installed to work with documents. Vi, Emacs
and OpenOffice.org Writer will all work and it is mostly a matter of
preference. Last but certainly not least, see if a few handy utilities
to process documents are installed. CVS, xmlto and/or the Docbook files
to work with the Wiki are all useful and necessary.
	3.) After GnuPG is installed go to
http://fedoraproject.org/wiki/DocsProject/UsingGpg/CreatingKeys and
follow the instructions there to generate a GPG key pair. For additional
information the Legacy site
http://www.fedoraproject.org/wiki/Legacy/PGPHowTo has a lot of good
information on key pair generation and use as well.	
	Then setup your email program to work with GnuPG so that signing and
verification of emails is possible. Instructions for each can be found
as follows:
		I.) Evolution
		A helpful page is located at
http://fedoraproject.org/wiki/DocsProject/UsingGpg/WithEvolution
		II.) Thunderbird
		Has help located here,
http://fedoraproject.org/wiki/DocsProject/UsingGpg/WithThunderbird
		III.) Kmail
		Located here
http://fedoraproject.org/wiki/DocsProject/UsingGpg/WithKmail is still a
work in progress and 
		IV.) Pine
		Located here
http://fedoraproject.org/wiki/DocsProject/UsingGpg/WithKmail is also a
work in progress.
===
-------------- 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/20060516/aaf9126d/attachment.sig>