Differences between revisions 1 and 22 (spanning 21 versions)
Revision 1 as of 2007-03-14 19:47:06
Size: 457
Comment: Create home page
Revision 22 as of 2011-01-24 00:44:29
Size: 2751
Editor: JustinBRye
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
#lang de ## page was renamed from I18n/OxfordReviewProject
## page was renamed from I18n/DebconfReview
= The Smith Review Project =
Line 3: Line 5:
= The debconf templates review project = The Smith Review Project (SRP) has been running since [[http://lists.debian.org/debian-devel-announce/2007/04/msg00000.html|April 2007]]. Its purpose is to review all the English texts associated with Debian packages: debconf templates, manual pages, and package descriptions. The work of the project, and any discussion about it, takes place on [[http://lists.debian.org/debian-l10n-english|the Debian English localisation mailing-list]].
Line 5: Line 7:
This is the home page of the debconf templates rewrite process. The project is named Smith because every nice project must have a name
and Smith is a commonly accepted "common name" for people in
English-speaking parts of the world. It also opens possibilities to
play on words with "blacksmith", "wordsmith" and the like. The project also
has a three-letter acronym name (SRP) which is mandatory in Free
Software projects.
Line 7: Line 14:
In short, the aim of this process is to review debconf templates for packages that use
some, based on their popcon score, and:

== The debconf templates review subproject ==

In short, the aim of this process is to review the debconf templates for packages that use them, based on their popcon score, and:
Line 14: Line 23:
This process will last for the whole etch-->lenny release cycle.  * [[I18n/SmithDebconfReviewProcess|Details of the process]]
 * [[I18n/SmithDebconfReviewGuidelines|Guidelines on style and language usage]]
 * [[http://bugs.debian.org/cgi-bin/pkgreport.cgi?tag=debconf-rewrite;users=debian-i18n@lists.debian.org;ordering=tracked|Already reported bugs]]
 * [[http://i18n.debian.net/debian-l10n/english/en.by_status.html|Current work status]]
 * [[http://people.debian.org/~bubulle/smith/sdrp-toolkit.tar.gz|Toolkit for reviewers]]
Line 16: Line 29:
 * [DebconfReviewProcess Details of the process] == The packages description review subproject ==

In the beginning, package descriptions will be reviewed along with debconf templates. This subproject could continue later by reviewing package descriptions for the packages that don't have debconf templates.

Some work has already be done by Clément Stenac, see :
 * http://comments.gmane.org/gmane.linux.debian.devel.package-descriptions/1
 * [[PackagesDescriptionsReview|Packages Descriptions Review]]


Colin Walters also wrote [[http://people.debian.org/~bubulle/smith/descriptions.html|some guidelines]] which should be used as a reference by maintainers and reviewers (as Colin resigned from the project, his account was removed and these guidelines are now hosted on ChristianPerrier's home page).

== The manpages review subproject ==

The purpose of that project is to review manual pages for Debian native packages. Manual pages for packages that have an upstream are not in the scope of this subproject.

== Discussion ==

 * Should we consider using wotomae or similar to track the work?

The Smith Review Project

The Smith Review Project (SRP) has been running since April 2007. Its purpose is to review all the English texts associated with Debian packages: debconf templates, manual pages, and package descriptions. The work of the project, and any discussion about it, takes place on the Debian English localisation mailing-list.

The project is named Smith because every nice project must have a name and Smith is a commonly accepted "common name" for people in English-speaking parts of the world. It also opens possibilities to play on words with "blacksmith", "wordsmith" and the like. The project also has a three-letter acronym name (SRP) which is mandatory in Free Software projects.

The debconf templates review subproject

In short, the aim of this process is to review the debconf templates for packages that use them, based on their popcon score, and:

The packages description review subproject

In the beginning, package descriptions will be reviewed along with debconf templates. This subproject could continue later by reviewing package descriptions for the packages that don't have debconf templates.

Some work has already be done by Clément Stenac, see :

Colin Walters also wrote some guidelines which should be used as a reference by maintainers and reviewers (as Colin resigned from the project, his account was removed and these guidelines are now hosted on ChristianPerrier's home page).

The manpages review subproject

The purpose of that project is to review manual pages for Debian native packages. Manual pages for packages that have an upstream are not in the scope of this subproject.

Discussion

  • Should we consider using wotomae or similar to track the work?