[Slackdocs] we need mainstream

Didier Spaier didier.spaier at epsm.fr
Thu Aug 23 14:40:29 CEST 2012

On 23/08/2012 13:13, Eric Hameleers wrote:
> On Thu, 23 Aug 2012, Didier Spaier wrote:
>> Hello everybody,
>> On 23/08/2012 09:09, asteroid wrote:
>>> Imho we need a clear way :
>>>     - 1st en english
>>>     - then translate (keeping the _same_ page name). That give us
>>>       http://docs.slackware.com/pt-br:slackware:install and this is
>>>       the portugal translation of the slackware:install page.
>> I disagree.
>> What is the rationale here?
>> Why pages in languages other than English would need to be a translation of existing English pages?
>> Granted, before a page be included in the documentation it should be checked from sort of a QA assurance,
>> as are slackbuilds @ slackbuilds.org, in whatever language they be written.
>> But I don't think that would need to match the new page against an existing one, written in English.
>> What we need is:
>> 1) Some basic rules to be followed, as for slackbuilds sumissions. I will make proposals.
>> 2) People volunteer and able to check that theses rule be applied in new or edited pages, whatever the language used.
>> I am confident that we can find enough skilled people to review pages written in their native language.
>> For instance I guess that Alien Bob would be able to review pages written in Dutch ;)
>> IMHO one of the main goals of the documentation is to encourage adoption of Slackware Linux by as many people as
>> possible all over the world. Having to say people not speaking English "You should either learn English first",
>> or "wait until somebody condescend to translate an Official English Page for you" will not help to reach that goal,
>> let alone "wait till English version be complete before we begin to translate anything" as I have seen posted on LQ.
>> Cheers,
>> Didier
> English is the primary language of the Wiki. That is a given.
> in order for the Wiki to determine if a page is available in multiple languages (which will be visible in the language selection drop-down in the left sidebar) a page must have the same name in all languages - only the language prefix is different (prefixing fr: for instance).
> I think iti s acceptible if someone writes a page in his own language first, on the condition that he creates a (possibly empty) english page as well. The english page could be a placeholder, informing that a localized version exists and that an editor is needed. Ideally the author of the localized page asks the co-operation of one of our editors to get a decent english translation into the Wiki. Google Translate service will be an essential tool in achiving that.
> Se http://docs.slackware.com/slackdocs:styleguide#translating_a_page where I tried to summarize.
> Eric

What does "primary language" mean, and why should it be "a given"?

Let's compare with Arch wiki. I am not sure at all that pages in "fr" or "nl" have an equivalent in "en".

I don't see any problem with that, as long as there be enough QA provided for every page.

I do not think that having every page in any other language first written in English or even translated in English should be mandatory.

In some cases it can even be irrelevant as the content on some page can be needed only to match some cultural characteristics specific
to a country or linguistic area.

If a localized version -- in Farsi for instance, as there are already some in the wiki ;) *is* a translation of a page in English or
reverse, then and only then a consistent naming would useful.

Now, "create an empty page in English to let know that a page in another language as no equivalent in English" is at the implementation
level. I only hope that doing that won't drive users in search of the English version to a blank pages...

There could be other ways to list untranslated_in_English pages. I will make proposals if I find one.

Anyhow, why not in the QA checklist include instructions to be followed or questions to be answered by the original author
and by the reviewer, like:
- Doesn't this page duplicate another one (even if the name or title differ)?
- If this page is a translation of another one, insure that their names be identical.
- Don't you think that this page's content would benefit people speaking other languages, at least English?
   If yes put it in the list_of_pages_awaiting_for_a_translation (whatever the way this list be implemented).

Though using it extensively I wouldn't rely on Google Translate for anything but getting a vague understanding of what the page is about,
but maybe that's only me.



More information about the Slackdocs mailing list