translation-quick-start-guide/en_US Accounts_And_Subscriptions.xml, 1.3, 1.4
Noriko Mizumoto (noriko)
fedora-docs-commits at redhat.com
Thu Sep 27 02:04:07 UTC 2007
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/CLAHowTo"
- /> 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 at 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></listitem>
+ <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>
More information about the Fedora-docs-commits
mailing list