Content for Plone

Fri Apr 21 23:04:22 UTC 2006

On Thu, 2006-04-20 at 20:04 -0400, Paul W. Frields wrote:
> On Thu, 2006-04-20 at 08:12 -0700, Karsten Wade wrote:
> > On Thu, 2006-04-20 at 07:38 -0400, Paul W. Frields wrote:
> > > Hi all Docsters,
> > 
> > > 1.  Who wants to take on the Account Setup Guide?  Keep in mind you
> > > won't have to do an awful lot of writing; it's mostly just collecting
> > > written bits from the wiki, expanding them where needed, and making sure
> > > everything flows nicely for an absolute newcomer.
> > 
> > Edward Haddock started this already, from the angle of just trying to
> > understand the sign-up process:
> > 
> > http://www.redhat.com/archives/fedora-docs-list/2006-April/msg00023.html
> 
> Excellent!  Edward, if you're out there, my canvassing was not meant as
> a slight, I simply forgot this was on the cooker already.  Thanks for
> stepping up to do this and -- if you have a chance -- let us know how
> you're doing, and whether you could use any help.
> 
Paul,
	No worries! Aloha all the same. :) I have been working on it a little.
I will paste here and you can look at it. As I said though, life has got
real busy lately. Also I am still on FC4 and haven't quite got the plan
finished to move to FC5. I only have the first section fleshed out a
little. 
Ed
"
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 at a
minimum join the fedora-docs-list.
	Next, ensure that the proper tool chain 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 4 but this can be checked using rpm.
		[xyz at xyz ~]$ rpm -qa up2date
		up2date-4.4.23-4
		[xyz at xyz ~]$ 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.
Outline:
1.) Subscribe to the fedora-docs-list, fedora-dsco-list and
fedora-announce-list
	a.) Visit the pages and filling in the needed information
	b.) An automated email message will be sent
	c.) Follow the link or respond to the email as outlined in the
instructions contained in the email

2.) Ensure that the proper tool chain installed
	a.) Package Management
		I.) up2date
		II.) Yum
		III.) RPM
	b.) Privacy Guard Software and Management Utilities.
		I.) GnuPG
		II.) Seahorse
		III.) KGpg
	c.) Email
		I.) Evolution
		II.) Thunderbird
		III.) Kmail
		IV.) Pine
	d.) Editors
		1.) Vi
		II.) Emacs
		III.) OpenOffice.org Writer
	e.) Utilities
		I.) CVS
		II.) xmlto
		III.) Docbook files
3.) Generate a GPG key and setup your email client
	a.) Create a key Pair
	b.) Post public key at pgp.mit.edu
	c.) GPG key management utilities
		I.) KGPG
		II.) Seahorse
		III.) At the command line
	d.) Setup email client to work with GPG
		I.) Evolution
		II.) Thunderbird
		III.) Kmail
		IV.) Pine
4.) Create a Bugzilla account(Red Hat)
	a.) Fill out subscription page
	b.) Receive email
	c.) Respond to or follow link in email
	d.) Account done
5.) Create a Fedora Project Account (Not the same as a Bugzilla
Account.)
	a.) Apply for an account
		I.) Fill out Subscription page
		II.) Receive an email
		III.) Respond to or follow link in email
		IV.) Account setup.
	b.) Request and Complete a Contributor License Agreement(CLA)
		I.) Form the accounts page click to have it emailed to the
		account on file.
		II.) Receive it and following the instructions in the email,
		fill it out, sign it with your GPG key and return it.
		III.) Get confirmation email. Done.
	c.) Download and save the client-side certificate.
6.) Post a self-introduction to the fedora-docs-list
	a.) Subject
	b.) Body
	c.) Include Public GPG Key
"
> > Edward -- if you want to write that up in plain text, OO.org doc, or
> > whatever you are most comfortable with, another of us can convert it to
> > XML and make it build with our toolchain.  Then you'd have a good, XML
> > reference source to continue work from.  We can also generate a
> > barebones outline in XML, with chapters sparsely populated with content
> > ready to fill out, based on your outline.
> 
> Yeah, what he said!
> 
> > Just two moving-forward ideas. :)
> > 
> > > 2.  How can we make our toolchain do the majority of the work for the
> > > CMS, like publishing and such?  This is a more subtle question that
> > > probably needs some batting around, and will require coordination with
> > > Websites.  Seth Vidal and I will help connect these dots, but folks here
> > > are intimate with our toolchain and we should be prepared to come to the
> > > table with some answers.
> > 
> > http://autobuild.org/ ?
> > 
> > Perhaps Elliot and Tommy's look at DIY on webtest.fedora might make the
> > argument for Autobuild stronger or ...?
> 
> I don't have any experience with (or, frankly -- other than looking
> through some of the intro/FAQ/doc pages -- knowledge of) this tool.  But
> certainly anything that would allow us to get our doc-building fingers
> into all sort of presentation-layer pies is a Great Idea.
> 
> > > 3.  It might be a good idea for us to start thinking about what docs
> > > content is "faster-evolving" than we can or should keep up with in CVS.
> > 
> > I'd like to see the Wiki graduate content into the CMS, just as it
> > graduates contributors from the lower-level tools to the upper-level
> > tools.  This models the growing pattern we all have as writers, from
> > basic content to more advanced content.
> 
> I couldn't agree more.  The interesting thing about the CMS is that it
> combines the easy idea-to-posting capability of a Wiki with some of the
> security and workflow aspects that would help us ensure quality
> documentation for all.  I am just getting started using it so I'm sure
> other people have a far better idea about how it all works.
> 
> -- 
> fedora-docs-list mailing list
> fedora-docs-list at redhat.com
> To unsubscribe: 
> https://www.redhat.com/mailman/listinfo/fedora-docs-list
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 191 bytes
Desc: This is a digitally signed message part
Url : http://lists.fedoraproject.org/pipermail/docs/attachments/20060421/3ac57e2c/attachment.bin