From Fedora Project Wiki

fp-wiki>ImportUser
(Imported from MoinMoin)
 
m (1 revision(s))
(No difference)

Revision as of 16:37, 24 May 2008

FDP CVS Usage Guidelines

Usage of CVS by the FDP is subject to all overarching policies, rules and guidelines established by the Fedora Project. Users receive access to CVS, when appropriate, through the process located at the Extras CVS access page .

Document Roles

This section may affect, be affected by, or duplicate material in the FDP Quick Start Guide .

  • The FDSC controls the overall repository of FDP documentation. The FDSC chair controls the overall configuration of the repository. FIXME: Do we want one or more backups in case of vacation or catastrophe?
  • The repository is subdivided by document.
  • Each document has a manager, typically a FDSC member who can assign access to that document. The manager is responsible for accountable for CVS commits for that document made by the other contributors.
  • Each document has one or more editors. An editor should be someone who can make CVS commits for that document.
  • Each document has one or more writers. A writer need not have CVS commit access for that document.
  • One person may fill more than one role. Other roles may also exist, such as that of technical reviewer. As participation in the FDP increases, these roles may separate more often.

CVS Write Access

All members of the FDSC must have CVS write access to fulfill the role of manager above.

The FDSC chair is currently the sole approver for CVS write access. As the project increases in size and scope, other approvers will be appointed, probably including some or all FDSC members. CVS write access is not a "cathedral," and should be granted wherever possible. Open documentation, like open software development, however, is a meritocracy. In order to secure CVS write access, a contributor must demonstrate that they bring value to the process. In open software development, a contributor demonstrates value by providing worthwhile ideas, backed up by code, to implement software improvements. In open documentation, a contributor demonstrates value by providing worthwhile ideas, backed up by technical writing, to implement documentation improvements.

The Documentation Quick Start Guide describes the process by which participants can enter the FDP. The goal of the Quick Start Guide is to ensure that any contributors are able to participate with as few barriers as possible. By providing technical writing samples, contributors demonstrate the value they bring to the process. These samples may be either original work, covered by the license used by the FDP, or substantial editing of existing work.

The process

TRUNCATED -- will continue shortly