headers
Sven Vermeulen | 3 Mar 2005 08:06
Picon
Favicon
Gravatar

Re: Lead translator

On Wed, Feb 23, 2005 at 04:22:51PM +0000, daniel wrote:
> How can I become the lead translator of the Hebrew (he) language?

Translating documents is part of the Gentoo Documentation Project [1] which is
involved in almost all documentation efforts. Most questions/answers are best
posed on the gentoo-doc <at> gentoo.org [2] mailinglist.

Xavier Neys (neysx <at> gentoo.org) is the lead for the internationalisation
subproject which contains the translation efforts. If you have any specific
questions you should ask him (although using the mailinglist is preferred).

All documentation development must adhere to some guidelines which are drawn in
the Gentoo Documentation Policy [3]. Tips and Tricks regarding documentation
development can be found in the Documentation Tips 'n Tricks [4].

Information regarding translations can be found in the Translators-HOWTO [5].

Hopefully this answers your questions.

Wkr,
      Sven Vermeulen

[1] http://www.gentoo.org/proj/en/gdp
[2] subscribe: gentoo-doc-subscribe <at> gentoo.org
    archives:  http://news.gmane.org/gmane.linux.gentoo.documentation
[3] http://www.gentoo.org/doc/en/doc-policy.xml
[4] http://www.gentoo.org/doc/en/doc-tipsntricks.xml
[5] http://www.gentoo.org/proj/en/gdp/translators-howto.xml

--

--
(Continue reading)

Permalink | Reply | 3 comments |
headers
Shyam Mani | 3 Mar 2005 08:10
Picon

Re: Lead translator

On Thu, 3 Mar 2005 08:06:32 +0100, Sven Vermeulen <swift <at> gentoo.org> wrote:

> [5] http://www.gentoo.org/proj/en/gdp/translators-howto.xml

That would be : http://www.gentoo.org/proj/en/gdp/doc/translators-howto.xml

:)

--

-- 
Shyam Mani
http://xinetd.accosted.net/

--
gentoo-doc <at> gentoo.org mailing list
Permalink | Reply | 0 comments |
headers
Andrés Pereira | 5 Mar 2005 07:44
Picon
Favicon

Statistics about docs

Hi there,

Is it possible to get access to some sort of web server log statistics,
particularly those related to the documentation?

We don't know how many people access the different parts of our
translated docs, so it could be interesting to know what are the
most requested ones, for instance. Although it is supposed that our
translated docs should be always up-to-date, it's a pretty
time-demanding task, and many of our users might be reading some
"popular doc" but it could be a bit outdated.

In the other hand, it would be useful to know if a user is trying
to read a doc, which is not translated but one of his|her previous
access was the doc webpage in his|her language. Anyway, i think that is
a datamining related task (session tracking or something like that),
perhaps not feasible by now, but it's still a good request, though :-).

Best regards,

--
Andrés Pereira
Permalink | Reply | 7 comments |
headers
Xavier Neys | 5 Mar 2005 09:17
Picon
Favicon

Re: Statistics about docs

Andrés Pereira wrote:
> Hi there,
> 
> Is it possible to get access to some sort of web server log statistics,
> particularly those related to the documentation?
> 
> We don't know how many people access the different parts of our
> translated docs, so it could be interesting to know what are the
> most requested ones, for instance. Although it is supposed that our
> translated docs should be always up-to-date, it's a pretty
> time-demanding task, and many of our users might be reading some
> "popular doc" but it could be a bit outdated.
> 
> In the other hand, it would be useful to know if a user is trying
> to read a doc, which is not translated but one of his|her previous
> access was the doc webpage in his|her language. Anyway, i think that is
> a datamining related task (session tracking or something like that),
> perhaps not feasible by now, but it's still a good request, though :-).

I had thought of doing something like that.
FYI, 404's on untranslated docs happen but are not significant and cannot be 
used to prioritize translations. The most read English docs would probably be 
a better indication. Stats on most read docs under /proj/ could help identify 
docs to translate.

Pending infra's approval, I can provide access logs stripped of any irrelevant 
info. IMO, only the timestamp and requested URI under /{doc,proj} should be 
provided.
Something like a list of
[05/Mar/2005:07:37:22 +0000] "GET /doc/en/handbook/handbook-x86.xml?part=3"
(Continue reading)

Permalink | Reply | 6 comments |
headers
Xavier Neys | 5 Mar 2005 09:43
Picon
Favicon

Updated stylesheets, please test them

Hi All,

I have made some adjustments to the guide.xsl and main.css stylesheets to
address a few requests we've received.
As those changes have a global impact, extra tests and feedback would be much
appreciated before anything is committed.

Changes:
* Improved readability (I hope) by not decreasing font size or only slightly,
usually for bold. It is not a good practice to decrease fonts below what the
user considers readable for him.
* Added font family name instead of just naming fonts.
* Thanks to the above, <pre> elements are now much more readable IMHO
* Right column coded only once (yes, it's coded twice in guide.xsl)
* Use border attribute instead of line.gif
* A few minor fixes, if you don't notice them, they're working :)

Just one example of what happens when Mozilla ends up using Helvetica:
http://dev.gentoo.org/~neysx/gentoo.org/gentoo-css.png
(current stylesheets on the right, new ones on the left)

Please browse around a subset of our site at
http://dev.gentoo.org/~neysx/gentoo.org/index.html
and let me know if anything is b0rked.
(GWN's, translations and some links are missing on purpose)

Thanks,
--
/  Xavier Neys
\_ Gentoo Documentation Project
(Continue reading)

Permalink | Reply | 9 comments |
headers
Sven Vermeulen | 5 Mar 2005 13:17
Picon
Favicon
Gravatar

Re: Statistics about docs

On Sat, Mar 05, 2005 at 09:17:44AM +0100, Xavier Neys wrote:
> Pending infra's approval, I can provide access logs stripped of any 
> irrelevant info. IMO, only the timestamp and requested URI under 
> /{doc,proj} should be provided.
> Something like a list of
> [05/Mar/2005:07:37:22 +0000] "GET /doc/en/handbook/handbook-x86.xml?part=3"

I'd like that. Lance, your call.

    Sven Vermeulen

--

-- 
  Documentation & PR project leader

  The Gentoo Project   <<< http://www.gentoo.org >>>
Permalink | Reply | 0 comments |
headers
Jan Kundrát | 5 Mar 2005 23:01
Picon

rp-pppoe: iface_eth0="up"

Hi there,
http://forums.gentoo.org/viewtopic-p-2154111.html#2154111 - user had had 
some problems with iface_eth0="up" in /etc/conf.d/net and newer 
baselayout (sys-apps/baselayout-1.11.9-r1).

Is this because of baselayout's internal changes, or just an error in docs?

-jkt

--

-- 
cd /local/pub && more beer > /dev/mouth

--
gentoo-doc <at> gentoo.org mailing list
Permalink | Reply | 6 comments |
headers
Andrés Pereira | 5 Mar 2005 23:04
Picon
Favicon

Re: Statistics about docs

Xavier Neys wrote:

> I had thought of doing something like that.
> FYI, 404's on untranslated docs happen but are not significant and
> cannot be used to prioritize translations.

Indeed, I was thinking about a user who visits the doc webpage in his
native language looking for some doc and since English is the default
language for untranslated docs, a click in one of those could indicate
the need to translate it (which is not a 404), that's why i suggest a
sort of session tracking, however your idea about getting the most read
English docs is a good start and it could help us.

> Pending infra's approval, I can provide access logs stripped of any
> irrelevant info. IMO, only the timestamp and requested URI under
> /{doc,proj} should be provided.
> Something like a list of
> [05/Mar/2005:07:37:22 +0000] "GET /doc/en/handbook/handbook-x86.xml?part=3"

That seems to be fine. I don't know if it is related to
this mailing list, but that approach could be easily adopted
in order to know the number of access to the GWN.

Cheers,

--
Andrés Pereira
Permalink | Reply | 4 comments |
headers
Chris Gianelloni | 6 Mar 2005 01:58
Picon
Favicon

Re: rp-pppoe: iface_eth0="up"

On Sat, 2005-03-05 at 23:01 +0100, Jan Kundrát wrote:
> Hi there,
> http://forums.gentoo.org/viewtopic-p-2154111.html#2154111 - user had had 
> some problems with iface_eth0="up" in /etc/conf.d/net and newer 
> baselayout (sys-apps/baselayout-1.11.9-r1).
> 
> Is this because of baselayout's internal changes, or just an error in docs?

The docs are written for what is currently stable, not what is currently
in testing.  If you choose to jump into the real of testing, you need to
take more care in paying attention to emerge messages and other such
things.  To answer your question, it is due to the internal changes in
baselayout which won't be documented until such time as they stabilize
and move to stable.

--

-- 
Chris Gianelloni
Release Engineering - Strategic Lead/QA Manager
Games - Developer
Gentoo Linux
Permalink | Reply | 5 comments |
headers
Jan Kundrát | 6 Mar 2005 11:31
Picon

Re: rp-pppoe: iface_eth0="up"

Chris Gianelloni wrote:
> On Sat, 2005-03-05 at 23:01 +0100, Jan Kundrát wrote:
> 
>>Hi there,
>>http://forums.gentoo.org/viewtopic-p-2154111.html#2154111 - user had had 
>>some problems with iface_eth0="up" in /etc/conf.d/net and newer 
>>baselayout (sys-apps/baselayout-1.11.9-r1).
>>
>>Is this because of baselayout's internal changes, or just an error in docs?
> 
> 
> The docs are written for what is currently stable, not what is currently
> in testing.  If you choose to jump into the real of testing, you need to
> take more care in paying attention to emerge messages and other such
> things.  To answer your question, it is due to the internal changes in
> baselayout which won't be documented until such time as they stabilize
> and move to stable.
> 

It wasn't my problem, btw, I just tried to help in the forums.

Anyway, this isn't the first timesomething similar appeared in the 
forums, so maybe the handbook should say:

"Don't set ~arch globally unless you really know what are you doing. A 
lot of things could work differently than specified in the handbook."

(Yes, I know that "We recommend that you only use the stable branch").

Or do we need bugreports/questions from users which cannot RTFM?
(Continue reading)

Permalink | Reply | 4 comments |

Gmane