Translation instruction on web page

[Yoshiki Hayashi <yo...@xemacs.org>]

I was reading docs-project web site and found out this:

    We also encourage you to place the name of the
    translator in a comment at the top of the file

Is this true?  I thought it was not the Apache way to
encourage ownership of a file.

On a related note, I noticed we don't have enough visibility
for non-committer contributors.  Can we add a new page or
enhance participants section at docs home page at
http://httpd.apache.org/docs-project/ to include them?  I'm
thinking mostly about other Japanese contributors but I
think there are lots of others in different language area
like Michael for German.

-- 
Yoshiki Hayashi

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org

Re: Translation instruction on web page

[Dirk-Willem van Gulik <di...@webweaving.org>]

On Tue, 2 Dec 2003, Yoshiki Hayashi wrote:

> I was reading docs-project web site and found out this:
>
>     We also encourage you to place the name of the
>     translator in a comment at the top of the file
>
> Is this true?  I thought it was not the Apache way to
> encourage ownership of a file.

True & True - the reason for this exception is that we've not yet worked
out how to make a larger community of translators, and how we facilitate
direct communication between translators of one language.

> On a related note, I noticed we don't have enough visibility
> for non-committer contributors.  Can we add a new page or
> enhance participants section at docs home page at
> http://httpd.apache.org/docs-project/ to include them?  I'm

Patches are welcome ! And subject to the usual +1 votes.

> thinking mostly about other Japanese contributors but I
> think there are lots of others in different language area
> like Michael for German.

Having a nice page which list the translators and their languages would be
good neess !

Dw.

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org

Re: Translation instruction on web page

[Yoshiki Hayashi <yo...@xemacs.org>]

Joshua Slive <jo...@slive.ca> writes:

>> I was reading docs-project web site and found out this:
>>
>>     We also encourage you to place the name of the
>>     translator in a comment at the top of the file
>>
>> Is this true?  I thought it was not the Apache way to
>> encourage ownership of a file.
>
> You are probably right.  This doesn't seem to be in line with the Apache
> way of doing things.

Dirk said it's true and obviously there're diffrent
opinions.  I can live with the recommendation but I just
felt odd about it because it's not along the line of Apache
way and nobody is following it.

>> On a related note, I noticed we don't have enough visibility
>> for non-committer contributors.  Can we add a new page or
>> enhance participants section at docs home page at
>> http://httpd.apache.org/docs-project/ to include them?  I'm
>> thinking mostly about other Japanese contributors but I
>> think there are lots of others in different language area
>> like Michael for German.
>
> I am certainly not religous about the contents of that list.  It should
> contain anyone who has made significant contributions to the
> documentation.  Anyone who has commit access qualifies, but I agree that
> shouldn't be a requirement.
>
> If you want, you can create a separate section for translators.  (Or just
> add them in to the main section.)

Here's a tentative patch to add a few contributors to main
page.  I think the web site is lacking the detailed
information about translation so I may come back with
different patch later.  The reorganization of translation
page I'm thinking is:

  Add how to participate in translation
    If there's existing team for a language, join it.  If
    there are committers for a language, send it to
    docs@httpd.apache.org is OK.

  Add how to add new language page
    (especially for 2.x because you need to tweak style
    files and build system)

  Reorganize participants list
    List commiters for each language
    Move error message contributor list to this page

Well, maybe I should just write a patch to get across my
points.

Re: Translation instruction on web page

[Joshua Slive <jo...@slive.ca>]

On Tue, 2 Dec 2003, Yoshiki Hayashi wrote:

> I was reading docs-project web site and found out this:
>
>     We also encourage you to place the name of the
>     translator in a comment at the top of the file
>
> Is this true?  I thought it was not the Apache way to
> encourage ownership of a file.

You are probably right.  This doesn't seem to be in line with the Apache
way of doing things.

>
> On a related note, I noticed we don't have enough visibility
> for non-committer contributors.  Can we add a new page or
> enhance participants section at docs home page at
> http://httpd.apache.org/docs-project/ to include them?  I'm
> thinking mostly about other Japanese contributors but I
> think there are lots of others in different language area
> like Michael for German.

I am certainly not religous about the contents of that list.  It should
contain anyone who has made significant contributions to the
documentation.  Anyone who has commit access qualifies, but I agree that
shouldn't be a requirement.

If you want, you can create a separate section for translators.  (Or just
add them in to the main section.)

Joshua.

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org