L10N Translation State of Guides on Zanata

In other languages: English (en) français (fr) [edit]

The documentation team is rebuilding a new system, this list is no longer valid. The current active docs are available on Pagure https://pagure.io/fedora-docs/

The last updating of this page occurred on 09/18/2017. Nevertheless, it doesn't mean that the Translation State Table of the guides has been updated as well.

Purpose of this Page

This page aims at facilitating communication between the Documentation Project and the translations teams regarding the translation of the various guides on Zanata. Each team should make its own copy of the English page using the language bar mechanism, copy the page, and fill the parameters for their language thus allowing everybody to have an overview of the translation state and to get some guidance about what deserves translation and what doesn't.

When copying the English page, don't copy the FAQ. After copy add a FAQ specific to your language for internal questions and prepend it with the followin anchor: <span id="target-faq"></span>.

Translation State Table

For updating by guide owners, see Updating by Guide Owners

For updating by language teams, see Updating by Language Teams

A question? Before asking, please have a look at the "Guidance for translators" colums and at the FAQ

Add a link here on your language page to point to your own FAQ

Guide Title		Priority	Latest version on docs.fedoraproject.com		Status on Zanata					Guidance for translators
Owner Updated	Repository Zanata	Low Médium High	English (above F20)	Target Language	Branch	Status	RO Reason	Translated %	Approved %
Click on the guide title to edit the template								Update only on translated page
Accessibility Guide			Not available		Master	Active
Sparks	Pagure
09/18/2017	Zanata
Amateur-radio Guide			Not available		Master	Active
jjmcd, Sparks	Pagure
09/18/2017	Zanata
Anaconda Addon Development Guide			Not available		Master	Active
	Pagure
09/18/2017	Zanata
Fedora Election Guide			Not available		Master	Active
Sparks	Pagure
09/18/2017	Zanata
Fedora Packager's Guide			Not available		Master	Read-only	This guide is not being actively maintained.
pmkovar	Pagure
09/18/2017	Zanata
Fedora Power Management Guide			Not available		Master	Read-only	This guide is not being actively maintained.
yruseva	Pagure
09/18/2017	Zanata
Fedora Security Guide			Not available		Master	Active
Sparks, kennepepe	Pagure
09/18/2017	Zanata
Fedora Software Collections Guide			Not available		Master	Read-only	This guide is not being actively maintained.
pmkovar	Pagure
09/18/2017	Zanata
Fedora SoftwareManagement Guide			Not available		Master	Active
Gomix	Pagure
09/18/2017	Zanata
Fedora Storage Administration Guide			Not available		Master	Read-only	This guide is not being actively maintained.
OPEN	Pagure
09/18/2017	Zanata
Fedora EFI Secure Boot Guide			Not available		Master	Active
Sparks	[??]
09/18/2017	Zanata
Fedora Installation Guide			F23 Edition 1		F23	Active
pbokoc	Pagure
09/18/2017	Zanata
Fedora Virtualization Deployement and Adminstration Guide			Not available		Master	Active
{{{owner}}}	{{{repository}}}
09/18/2017	Zanata
FreeIPA Guide			Not available		Master	Read-Only	This guide is not being actively maintained.
{{{owner}}}	{{{repository}}}
09/18/2017	Zanata
Musician Guide			Not available		Master	Active
crantila	Pagure
09/18/2017	Zanata
Networking Guide			F23 (DRAFT)		Master	Active
StephenW	Pagure
09/18/2017	Zanata
Fedora System Administrator's Guide			F23(DRAFT)		Master/F22/F21	Active
StephenW	Pagure
09/18/2017	Zanata
Translation Quick Start Guide			Not available		Master	Read-only	This guide is not being actively maintained.
{{{owner}}}	{{{repository}}}
09/18/2017	Zanata
Virtualization Getting Started Guide			F23		Master	Read-only
dmparker	Pagure
09/18/2017	Zanata
Fedora OpenSSH Guide			Not available		Master	Active
	Pagure
09/18/2017	Zanata
Multiboot Guide			F23		Master	Active
chrisrobets	Pagure
09/18/2017	Zanata
SELinux User and Administrator's Guide			F22		Master	Active
bancinco
09/18/2017	[Not on Zanata]
SELinux-Guide					Master	Active
	Pagure
09/18/2017	[Not on Zanata]

Updating by Guide Owners

Updating an Existing Guide

Each line of the table is a template for the various languages. To edit this template, just click on the name (link) of the guide to go to the template page. Edit the template and fill the parameters of the Guidetrstat template as shown in this example :

{{Guidetrstat
|color=
|title=Accessibility Guide
|owner=
|repository=Pagure
|update={{REVISIONMONTH}}/{{REVISIONDAY}}/{{REVISIONYEAR}}
|zanata=Zanata
|priority=
|availabilityEn=Not available
|availabilityTr={{{availabilityTr|}}}
|branch=Master
|status=Active
|roreason=
|percenttr={{{percenttr|}}}|percentappr={{{percentappr|}}}
|trupdate={{{trupdate|}}}
|guidance=}}[[Template:{{PAGENAME}}/doc]]

Please give only values to the parameter of the Guidetrstat template (such as branch, green color) not to the parameters that make use of this templates' parameters (e.g. availabilityTr={{{availabilityTr}}}) which are for translators.

• Parameters available for changes:
  • color : To change the color of the whole line. Red for Read-only, magenta for guide not yet on Zanata.
  • owner
  • repository : the link to the repository where the file for the book reside
  • zanata : the link to the zanata project
  • priority : High, Medium"" or "Low"
  • availabilityEN : Version which is available en docs.fedoraproject.org or Not available
  • branch : A / separated list of the branches that are available for translation on Zanata (e.g.Master/F24/F23)
  • status : Active if translatable, Read-only if not translatable
  • roreason : why this guide is read-only on Zanata
  • guidance: When the situation is not obvious on Zanata, please give some guidance for translators

All the changes made here are for all the languages!

Adding a New Guide

To add a new guide you must create a Template:Guidetrstat/<TEMP_NAME> template where <TEMP_NAME> is the name you give to the template that should resembles the name of the guide e.g. Template/Guidetrstat/networking for the Networking Guide (of course the name should not exist yet).

Then copy the following into the template, replacing <TEMP_NAME> and <GUIDE_NAME>

{{Guidetrstat
|color=
|title=[[Template:Guidetrstat/<TEMP_NAME>|<GUIDE_NAME>]]
|owner=
|repository=
|update={{REVISIONMONTH}}/{{REVISIONDAY}}/{{REVISIONYEAR}}
|zanata=
|priority=
|availabilityEn=
|availabilityTr={{{availabilityTr|}}}
|branch=
|status=
|roreason=
|percenttr={{{percenttr|}}}|percentappr={{{percentappr|}}}
|trupdate={{{trupdate|}}}
|guidance=}}<noinclude>[[Template:{{PAGENAME}}/doc]]
</noinclude>

Once the template created and saved, edit this page and add the following lines in the table, replacing <TEMP_NAME> with the name of the template you have just created :

{{Guidetrstat/<TEMP_NAME>
|availabilityTr=
|percenttr=
|percentappr=
}}

Save the page. Then click the guide's name in the table to update it.

Updating by Translation Teams

Do not edit the English page
Translation teams should never edit the English page but their translated page instead

How to make changes is quite obvious. Hereafter is an example :

{{Guidetrstat/accessibility
|availabilityTr=Not available
|pertenttr=50%
|percentappr=0%
|trupdate= 7 avril 2016
}}

In the example above, the line for the Accessibility Guide has been changed. Changes concern only four parameters:

• • availibilityTR : Whether the translated guide is available on docs.fedoraproject.org or not. If yes, give the last version available, if not, just write Not available
  • percenttr: Give the percentage of translated messages
  • percentappr: Give the percentage of approved translated messages.
  • trupdate : Give the date of your update for this guide

FAQ

• When there are several branches present on Zanata, which one to update?

* Answer:

• When the latest version on Zanata refers to an English guide marked DRAFT, what to do?

* Answer:

• When an English Guide is only visible on the web site for an earlier version(more than 1 version backward), what to do?

* Answer:

• Should a Guide not available on the web site but present on Zanata only in a master branch be translated or not?

*Answer: