DRAFT - "CVS now open" - please comment by Midnight UTC 28 April

[Gavin Henry]

On Thursday 28 Apr 2005 23:05, Karsten Wade wrote:
> ## While the number of lurkers on this list is low, I want to solicit
> ## some feedback about this CVS announcement.  Low level, this is not
> ## vital, just if you catch this in the next few hours, I'll take some
> ## advise.  Otherwise, I'm sending this puppy by 6 pm PDT.
>
> Hi fellow writers and editors:
>
> We are mighty pleased to announce the opening of CVS for the Docs
> Project.
>
> Our intention is to have the lowest barrier to entry possible.  After
> getting our grubby little hands, uh, I mean, fine Elven fists on the
> keys a few weeks ago, we have been formulating some philosophy and
> guidelines to help make our experience nicer.
>
> ## Quick Version of How To Get CVS Access:
>
> * Read the CVSAccess guidelines Wiki page[1]
> * Do a proper self-introduction to the list
> * Show that you have something to put in CVS:  as an editor through
> picking something to edit or as a writer through producing a draft or
> working outline
> * Using the proper process[2], get an account on cvs.fedora.redhat.com
> [3], put yourself in the 'cvsdocs' group, and wait for approval.
>
> [1] http://www.fedoraproject.org/wiki/DocsProject/CvsUsage
> [2] http://www.fedoraproject.org/wiki/Extras/CvsAccess
> [3] https://admin.fedora.redhat.com/accounts/
>
> This all presumes you have read the Documentation Quick Start[4] and are
> familiar with the Fedora Project Documentation Guide[5].  Don't worry
> about the DocBook/XML stuff right now. :)
>
> [4] http://fedora.redhat.com/participate/documentation-quick-start/
> [5] http://fedora.redhat.com/participate/documentation-guide/
>
> ## What Philosophy?
>
> Golden Rule in effect.  Treat others and their directories in CVS as you
> would have them treat you and your files.
>
> Only truly vital resources will have CVS ACLs.  You are on your best
> behavior as a community member to Do The Right Thing.
>
> Don't put any illegal stuff in CVS.  That would be BAD.
>
> Don't attempt (or succeed) in cracking the CVS host systems, or use it
> as a launchpad for crack attempts.  That would be VERY BAD.
>
> ## Who Gets to Go Where?
>
> Read the CVSAccess[1] page for details.  The quick version is that
> assigned writer(s), editor(s), and a doc manager are the only ones who
> should be messing around in a particular directory.
>
> The doc manager is the single person accountable for what goes on in the
> directory. It can be one of the writers, editors, or third person
> otherwise not involved.  To start, it's likely to be one of the FDSCo
> members, lending a wise and guiding hand where needed.  *cues ethereal
> music*
>
> Each doc has one or more writers who must collaborate together within
> the same repository.  Thank ye gods for revision control!
>
> An editor can edit for technical and grammatical/wordsmith details.  The
> editor must know and enforce the style guidelines from the Doc Guide[6].
> There may be more than one editor to fill all the roles.
>
> [6] Forthcoming URL _will_be_

Looks good to me.

-- 
Kind Regards,

Gavin Henry.
Managing Director.

T +44 (0) 1224 279484
M +44 (0) 7930 323266
F +44 (0) 1224 742001
E ghenry at suretecsystems.com

Open Source. Open Solutions(tm).

http://www.suretecsystems.com/