Author: noriko
Update of /cvs/docs/translation-quick-start-guide/en_US
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv23706
Modified Files:
Accounts_And_Subscriptions.xml
Log Message:
entire content has been rewritten to contain up-to-date procedure
Index: Accounts_And_Subscriptions.xml
===================================================================
RCS file: /cvs/docs/translation-quick-start-guide/en_US/Accounts_And_Subscriptions.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- Accounts_And_Subscriptions.xml 4 Sep 2007 23:40:03 -0000 1.3
+++ Accounts_And_Subscriptions.xml 27 Sep 2007 02:04:05 -0000 1.4
@@ -12,6 +12,29 @@
<section id="sn_accounts">
<title>Accounts and Subscriptions</title>
+ <para>
+ First and most important step to become Fedora Translator is to obtain an account
and subscription(s). At the end of this chapter, you should successfully complete all
steps requiring to obtain your account and subscription(s). Any question, feel free to
post in the lists or ask for help at iirc (
irc.freenode.org/#fedora-l10n).
+ </para>
+ <section id="signup-ml">
+ <title>Sign up to the mailing list</title>
+ <procedure>
+ <step>
+ <para>
+ Visit <ulink
url="https://listman.redhat.com/mailman/listinfo/fedora-trans-list/&... and
subscribe to the main translation mailing list.
+ </para>
+ </step>
+ <step>
+ <para>
+ You will receive a confirmation email which contains a link. Click it!
+ </para>
+ </step>
+ <step>
+ <para>
+ Check out <ulink
url="http://fedoraproject.org/wiki/L10N/Teams/"/>
to see if there is a special mailing list for your language. If yes, subscribe to that
too.
+ </para>
+ </step>
+ </procedure>
+ </section>
<section id="sn-ssh-key">
<title>Making a SSH Key</title>
@@ -67,134 +90,215 @@
</procedure>
</section>
- <section id="sn-accounts-trans">
- <title>Accounts for Software Translation</title>
-
- <para>
- To participate in the &FP; as a translator you need an account.
- You can apply for an account at <ulink
-
url="http://i18n.redhat.com/cgi-bin/i18n-signup/"/>. You need
- to provide a user name, an email address, a target language
- — most likely your native language — and the public
- part of your SSH key.
- </para>
-
- <para>
- There are also two lists where you can discuss translation
- issues. The first is <firstterm>fedora-trans-list</firstterm>, a
- general list to discuss problems that affect all languages.
- Refer to <ulink
-
url="http://www.redhat.com/archives/fedora-trans-list"/> for
- more information. The second is the language-specific list,
- such as <firstterm>fedora-trans-es</firstterm> for Spanish
- translators, to discuss issues that affect only the individual
- community of translators.
- </para>
- </section>
-
- <section id="sn-accounts-docs">
- <title>Accounts for Documentation</title>
- <para>
- Follow this procedure to start working directly with the &FDP;
- to translate documentation.
- </para>
- <procedure>
- <step>
- <para>
- The &FDP; encourages all participants to sign e-mails with a
- GPG key. To create a key, use the following command:
- </para>
-
+ <section id="sn-gpg-key">
+ <title>Making a GPG Key</title>
+ <procedure>
+ <step>
+ <para>
+ Generate a key by typing in a command line:
+ </para>
<screen>
<command>gpg --gen-key</command>
</screen>
-
- <para>
- A series of prompts guides you through the process. Press
- <keycap>Enter</keycap> to select the default values.
- </para>
- <para>
- You must export your public key so other people can verify
- your signature. Use this command to export your key to a
- public server:
- </para>
-
+ <para>
+ A series of prompts guides you through the process. The default values are usually
OK. Choose a good password. Finally, your key will be created.
+ </para>
+ </step>
+ <step>
+ <para>
+ Search for the part saying something like "pub 1024D/1B2AFA1C". Your
Key ID is the 8-digit-long hex word after the '/' (in this example, the GPG Key ID
is "1B2AFA1C"). Yours will be different; write it down.
+ </para>
+ </step>
+ <step>
+ <para>
+ Export your public key to a public server (so that others can find it) by typing
in a command line (substitute GPGKEYID with your key ID):
+ </para>
<screen>
<command>gpg --keyserver
pgp.mit.edu --send-keys GPGKEYID</command>
</screen>
-
- </step>
- <step>
- <para>
- Request a membership on the &FDP; mailing list. To do that,
- fill out the form at <ulink
-
url="http://www.redhat.com/mailman/listinfo/fedora-docs-list/"/>.
- </para>
- </step>
- <step>
- <para>
- You should post a self-introduction to the &FDP; mailing
- list. For details, refer to <ulink
-
url="http://fedoraproject.org/wiki/DocsProject/SelfIntroduction"...;.
- </para>
- </step>
- <step>
- <para>
- You also need to sign up for a &FED; account. Visit <ulink
-
url="https://admin.fedoraproject.org/accounts/"/> and
- select the link <guilabel>Apply for a new
- account</guilabel>. After filling out this form, you have
- a basic account.
- </para>
+ </step>
+ </procedure>
+ </section>
+
+ <section id="sn-apply-account">
+ <title>Apply for an account</title>
+ <procedure>
+ <step>
+ <para>
+ You need to sign up for a &FED; account. Visit <ulink
url="https://admin.fedoraproject.org/accounts/"/> and select the link
<guilabel>Apply for a new account</guilabel>.
+ </para>
+ </step>
+ <step>
+ <para>
+ Fill in the form and choose a password for your Fedora account. You should now
have a GPG keyID and an SSH key to use on the form. Also, in the Comments field write the
languages you are planning on working on.
+ </para>
+ </step>
+ </procedure>
+ </section>
+
+ <section id="sn-sign-cla">
+ <title>Sign the CLA</title>
<para>
- You must complete the Contributors License Agreement
- (<acronym>CLA</acronym>), refer to <ulink
-
url="http://fedoraproject.org/wiki/Infrastructure/AccountSystem/CLAH...
- /> for instructions.
+ You must complete the Contributors License Agreement
(<acronym>CLA</acronym>).
</para>
- </step>
- <step>
+ <procedure>
+ <step>
+ <para>Visit:
https://admin.fedoraproject.org/accounts/send-cla.cgi. You
should be able to authenticate using the username/password from the previous process.
+ </para>
+ </step>
+ <step>
+ <para>Check your emails. You should have received an email with an
attachment. You are now going to sign this file and reply to the email. Save the
attachment to your local computer (say, your Desktop).
+ </para>
+ </step>
+ <step>
+ <para>Edit the file with your favourite text editor (double-click on it).
Type in it "I agree" and your full name.
+ </para>
+ </step>
+ <step>
+ <para>
+ Digitally sign the text file using your GPG key (by providing your GPG password)
with following command:
+ </para>
+<screen>
+<command> gpg -a --sign fedora-icla-{username}.txt </command>
+</screen>
+ <para>You now have another file on your Desktop that ends with .asc.
+ </para>
+ </step>
+ <step>
+ <para>
+ Open again your email client and Reply to the CLA email. Attach the file which
ends with .asc, and send the email.
+ </para>
+ </step>
+ </procedure>
+ </section>
+
+ <section id="sn-join-cvsl10n">
+ <title>Join the cvsl10n group</title>
+ <procedure>
+ <step>
+ <para>
+ Visit:
https://admin.fedora.redhat.com/accounts/userbox.cgi?_edit=1
+ </para>
+ </step>
+ <step>
+ <para>
+ Go to <guilabel>Add new membership</guilabel> at the bottom of the
page. In the field <guilabel>Groupname</guilabel>, enter
<userinput>cvsl10n</userinput> and select
<guilabel>Add</guilabel>.
+ </para>
+ </step>
+ <step>
+ <para>
+ At this point, an admin will be notified and will offer to sponsor you. This
might take from some minutes up to a day or two.
+ </para>
+ </step>
+ </procedure>
+ <caution>
+ <para>
+ The rest of the steps help you test your access and grant you privileges to all
the Fedora infrastructure you might need in the near future. Language maintainers and
people starting new languages should follow them. Although they are optional for
translations, everyone is encouraged to follow them.
+ </para>
+ </caution>
+ <important>
+ <para>
+ Some of the Fedora modules are still hosted on the
i18n.redhat.com system, which
is not enabled to work with the cvsl10n group. To translate modules hosted there, please
visit:
http://i18n.redhat.com/cgi-bin/i18n-signup. This warning will probably be
deprecated soon.
+ </para>
+ </important>
+ </section>
+
+ <section id="sn-test-access">
+ <title>Test your access</title>
+ <procedure>
+ <step>
+ <para>
+ # Install cvs (if you don't already have it) by typing in a command-line:
+ </para>
+<screen>
+<command>su -c 'yum install cvs' </command>
+</screen>
+ </step>
+ <step>
+ <para>
+ Do a cvs checkout of some PO files by typing the following in a command-line (and
substituting 'username' with your username). You will be asked the password for
your SSH key.
+ </para>
+<screen>
+<command>export CVSROOT=:ext:username@cvs.fedoraproject.org:/cvs/l10n
+ cvs co web
+ ls web/flpweb/po
+</command>
+</screen>
+ </step>
+ </procedure>
+ </section>
+
+ <section id="sn-create-wikiacct">
+ <title>Create a wiki account</title>
+ <procedure>
+ <step>
+ <para>
+ Visit <ulink
url="http://fedoraproject.org/wiki/UserPreferences/"/>. As a username, choose
something like 'FirstnameLastname' and click <guilabel>Create
Profile</guilabel>.
+ </para>
+ </step>
+ <step>
+ <para>
+ At this point, someone should give you Edit access on the wiki. Either contact
someone from the Edit Group <ulink
url="http://fedoraproject.org/wiki/EditGroup/"/> or add your name to the
EditGroupQueue <ulink
url="http://fedoraproject.org/wiki/EditGroupQueue/"/> and someone will add
you shortly.
+ </para>
+ </step>
+ <step>
+ <para>
+ If you are starting a new language, or want to step up as the maintainer of one,
add your information on the L10N/Teams <ulink
url="http://fedoraproject.org/wiki/L10N/Teams/"/> page.
+ </para>
+ </step>
+ </procedure>
+ </section>
+
+ <section id="sn-intro-yourself">
+ <title>Introduce yourself</title>
+ <procedure>
+ <step>
+ <para>
+ Once you have edit access on the wiki, create a personal page at a URL like this:
<ulink
url="http://fedoraproject.org/wiki/FirstnameLastname/"/>. This is
very useful for Fedora contributors to get to know and contact each other.
+ </para>
+ </step>
+ <step>
+ <para>
+ Post a short self introduction <ulink
url="http://fedoraproject.org/wiki/L10N/Join/SelfIntroduction/"... to the
<systemitem>fedora-trans-list</systemitem> mailing list and to the list of
your local team.
+ </para>
+ </step>
+ </procedure>
+</section>
+
+ <section id="sn-bugzilla-account">
+ <title>Create a Bugzilla account</title>
<para>
- Once you have successfully completed the CLA, return to the
- account system and select <guilabel>Edit Your
- Account</guilabel>. Enter the password you received by
- email and select <guilabel>Add new membership</guilabel> at
- the bottom of the page. In the field
- <guilabel>Groupname</guilabel>, enter
- <userinput>cvsl10n</userinput> and select
- <guilabel>Add</guilabel>. This action requests access
- to the CVS repository where the documentation is stored.
+ Visit <ulink
url="https://bugzilla.redhat.com/bugzilla/createaccount.cgi/"/> to create a
Bugzilla account.
</para>
- <important>
- <title>CVS Access is Not Automatic</title>
+ </section>
+
+ <section id="sn-check-list">
+ <title>Checklist</title>
+ <para>
+ At the end, you should have the following:
+ </para>
+ <itemizedlist>
+ <listitem><para>Subscription to fedora-trans-list mailing list and, if
there is one, to your own language's one</para></listitem>
+ <listitem><para>One SSH key</para></listitem>
+ <listitem><para>One GPG key</para></listitem>
+ <listitem><para>A Fedora account</para></listitem>
+ <listitem><para>Membership to the 'cvsl10n'
group</para></listitem>
+ <listitem><para>A wiki account</para></listitem>
+ <listitem><para>Your language and translation team appear on <ulink
url="http://fedoraproject.org/wiki/L10N/Teams/"/></para&g...
+ <listitem><para>A bugzilla account</para></listitem>
+ <listitem><para>A personal homepage on the
wiki</para></listitem>
+ <listitem><para>A self introduction sent to the mailing
list</para></listitem>
+ </itemizedlist>
+ </section>
+
+ <section id="sn-final">
+ <title>Finally!</title>
<para>
- When you fill out this form, you are not automatically
- granted write access to the CVS repository. You may need
- sponsorship from one of the &FDP; managers to get this
- access.
+ Sit back and enjoy your achievement.
+
+ You are now a fully recognized member of the Fedora community, capable of digitally
signing documents and emails, submitting contributions to our CVS, publishing content on
the wiki, submitting bugs, following the discussions of our groups and joining other
Fedora teams!
</para>
- </important>
- </step>
- <step>
- <para>
- The next step is to create a wiki account. Fill out the form
- at <ulink
-
url="http://fedoraproject.org/wiki/UserPreferences" />,
- and select <guilabel>Create Profile</guilabel>.
- </para>
- </step>
- <step>
- <para>
- Contact any person with edit access and ask to be added to
- the Wiki edit account in <ulink
-
url="http://fedoraproject.org/wiki/EditGroup" />. You can
- do this on IRC or by posting on the
- <systemitem>fedora-docs-list</systemitem> mailing list you
- joined in a previous step.
- </para>
- </step>
- </procedure>
- </section>
+ </section>
</section>