gmane.linux.gentoo.documentation

Re: Expanding categories' descriptions

Sven Vermeulen — 2013-03-31T06:29:29

idea to expand the categories' descriptions (found in the corresponding
metadata.xml files) with more accurate descriptions of which packages are
welcome to fit in which categories.

Hi Denis,

You should suggest this on gentoo-dev mailinglist.

Wkr,
   Sven

Re: Expanding categories' descriptions

Mike Frysinger — 2013-03-30T20:42:34

please do not send html e-mails
-mike

Expanding categories' descriptions

Denis M. — 2013-03-30T20:17:49

Hello,

I believe it's necessary to bring this matter here. I think it's a good
idea to expand the categories' descriptions (found in the corresponding
/metadata.xml/ files) with more accurate descriptions of which packages
are welcome to fit in which categories.

The current descriptions are very vague and aren't probably in the best
shape to bring users' a good idea what certain category is about and
what packages are to be found there.

This can also be an issue for (new) ebuild-writers (either
user-contributing ebuilds or just gentoo developers that are not sure
about it).

This is of course checked by a gentoo developer if new ebuilds are to be
submitted via the bugzilla, but I still think we should provide a better
understanding of the categories.

If expanding the /metadata.xml/ files does not seem a good idea, we
should at least make a little bit more comprehensive description
somewhere in the /gentoo.org/doc// or /wiki.gentoo.org/ pages.

What do you think about it?


Regards,
Denis M. (Phr33d0m)

Re: [RFC] GDP policy updates

Joshua Saddler — 2013-03-21T23:26:29

On Wed, 20 Mar 2013 17:13:01 +0000
Sven Vermeulen <swift< at >gentoo.org> wrote:


approved.


approved. i'd forgotten that was even setup that way. we haven't used it like that in years.


approved. especially since i'm away quite a bit these days with health issues -- i read everything sent in to bugzie and the lists, but am unable to do much activity-wise. more than one designated contact, and a streamlined recruitment, is a good idea.

(i volunteer you, if you're willing. :) )


approved, tentatively. we need to be careful going forward to make sure that folks at least know the basics of GDP so they don't break the tree (and/or their translations). the point of the quiz is to make sure that everyone is "on the same page" so that we don't have wildly different code styles, broken code, or lacking knowledge on how to do "stuff."

we can keep an eye on potential new recruits without the up-front strict requirements; make sure they know what they're doing. we do already have guidelines in place for translations f

Re: [RFC] GDP policy updates

Chema Alonso — 2013-03-21T18:13:16

...

Sounds good, +1 here.

Regards.

Re: [RFC] GDP policy updates

Tobias Heinlein — 2013-03-20T18:17:54

Looks great!

+1

Regards,
Tobias

On 20.03.2013 18:13, Sven Vermeulen wrote:

[RFC] GDP policy updates

Sven Vermeulen — 2013-03-20T17:13:01

Hi guys,

I'd like to suggest a few changes on our GDP policy, namely:

- updating the license comment if you use a different license should be
  mandatory (hence switch from "should" to "must")

  Reason: I think this is a "typo" as "must" fits more in the idea of that
  paragraph.

- drop using metadoc.xml for registering long outstanding bugs

  Reason: it was a nice idea, but never truely used

- have project lead (or delegated person) "decide" on the recruitment
  process / progress

  Reason: we already dropped the time frame windows in the past, but wasn't
  really clear who then decides that a phase can go through or not. So make
  it explicit that it is the lead (or a delegated person)

- drop mandatory gdp quiz, make it recommended

  Reason: we already have a contribution period where the recruit sends in
  contributions or patches; the knowledge on the GuideXML, as far as needed
  for the tasks the recruit wants to do, should be apparent from the
  contributions.

  The quiz requires more knowled

Bug 377179 updating of xen

José Fournier — 2013-03-15T18:01:55

Hi Sven,

As I cannot commit the file, I hesitated to put status to " Resolved" 
--> Fixed but I have few choices.
Please have a look.

Regards

José

Re: Date problem

Sven Vermeulen — 2013-03-14T19:24:07

The wiki mentions that you can ask on #gentoo-wiki or through the
wiki< at >gentoo.org address. I'm not sure if many wiki folks are on the
gentoo-doc mailinglist.

Wkr,
Sven Vermeulen

Re: Date problem

José Fournier — 2013-03-14T10:57:35

(Sorry for linked words in this mail probably due to a bug in my config)

Hi,

Can somebody tell me how to be allowed to translate pages of the 
official wiki ?
I tried but I was told you are not allowed to translate. Clicking the 
"request permission" button lead me to a Project:Translator empty page !

Regards

José

Re: French documentation : no more cam's French documentation information

José Fournier — 2013-03-13T09:32:21

I still have this problem with Thunderbird (words linked together) that 
makes my mails ugly. No idea of what could be the reason!

Re: French documentation : no more cam's French documentation information

José Fournier — 2013-03-13T09:29:34

Thank you too. It's a real pleasure to contribute to such awonderful 
Linux distroand, this way, allow developers to concentrate on the 
fundamentals, I mean the software itself.

Re: French documentation : no more cam's French documentation information

Xavier Miller — 2013-03-13T09:00:57

Quoting José Fournier <jaaf.forums< at >zoraldia.com>:


Thank you very much, José !!!

If you need some help, there are people at #gentoofr willing to help.

Kind regards,
Xavier

Re: French documentation : no more cam's French documentation information

José Fournier — 2013-03-13T08:58:15

Hi Xavier,

I am presently in the course of updating the French documentation, with 
the help of Sven Vermeulen that commits the files for me. Please don't 
remove them now as I already did almost all the handbook, the 
alsa-guide, the alternative installation guide. Some of the files are 
still waiting for committing in bugzilla.

I am volunteerto revive the French team but I was explained by Sven that 
it can take some months before I can demonstrate my ability to doso (I 
am not a developer).
This is not a problem to me as I feel enthusiastic and things are going 
well the present way.

Regards

José

French documentation : no more cam's French documentation information

Xavier Miller — 2013-03-13T08:13:30

Hello,

After some months of inactivity, some french speaking volunteers  
proposed to continue to contribute to the update of the very old  
french documentation.

I tried to get the status left by the official absent team, but the  
page with the tools is no more accessible :  
https://dev.gentoo.org/~cam/gentoo-doc-fr/ is dead.

So the volunteers cannot contribute, I will stop this volunteer lead  
and let the french documentation in the hands of the Gentoo developers.

Could you please update that documnentation or delete it ? It is too  
comfusing for french-speaking people, we get still now remarks about  
HAL (can I say "LOL" ?).

Kind regards,
Xavier Miller.

Re: Beginner needs help

Xavier Miller — 2013-03-01T07:26:53

Quoting Damien Levac <damien.levac< at >gmail.com>:


Hello
There is at least 3 years updates to integrate, since the french  
translation is not active anymore.

I started an initiative to update the French manual [1], but I don't  
have not so much time for now (I had some free time before, but I  
changed of work and have things to do =:o>)

Feel free to collaborate to that unofficial initiative, the best way  
for non-developers is to files documentation bugs with patch to  
updated documents.

Kind regards,
Xavier Miller

[1]  
http://forums.gentoo.org/viewtopic-t-931252.html?sid=5ff5d43f539978fdd41e5bbca16bd415

Re: Beginner needs help

Damien Levac — 2013-03-01T05:06:06

Hmm, never thought of doing translations.
Is there a lot of stuff left to do in English to French translations? Or
just some article here and there?

Damien

On 02/28/13 23:47, José Fournier wrote:

Re: Beginner needs help

José Fournier — 2013-03-01T04:47:06

Hi,

I think I have found a solution to my problem. In fact copying the 
original file from EN to FR folder and then translating works. The only 
trouble I had was that the link to the file (chapter) was not yet 
present in the master document /doc/fr/handbook/handbook-amd64.xml.
We have something to learn every day .

Now everything renders correctly in the browser.


On 02/28/13 18:47, José Fournier wrote:

Beginner needs help

José Fournier — 2013-02-28T17:47:09

Hi,

Up to now I have updated the translation of files that were already 
committed both sides (original and translation). Using gorg on a 
checkout of the CVS provides a very easy way to see the English file and 
the translated file side by side in a browser. This way one can check 
the textual aspect of the document as well as its rendering (the tags).
Now I come to a file which original only exists. Copying it into the 
equivalent folder of the target language doesn't suffice to make it 
appear in the browser. The only thing that is rendered is "cannot 
convert nil into string". I guess the file has to be committed first to 
be viewable in the browser. But I have no right to do so at the moment.
My question is how to do this locally in order to have gorg render it 
normally ?

I hope my question is not too stupid and that the answer is not obvious 
in the GDP documentation.

Thanks in advance for help

José

Re: Date problem

José Fournier — 2013-02-27T15:04:42

Hi Tobias,

Thank you very much for answering.
If I understand well what you are saying the warning doesn't work on a 
per page basis, but rather on a per book basis.
Despite this I still have trouble understanding the strangeness of the 
dates that appear even on my local copy where a larger amount of file is 
updated (including doc/fr/handbook/handbook-amd64.xml). I think that 
with time I will grasp the mechanism better thanks to your remark.

Whatever it is, this seems to mean that, from the user point of view, it 
is impossible to trust a translated page, even important, as long as,  a 
trivial detail on one page of all the book is not translated. Rather 
difficult, if my understanding is good,  for  a translator to convey 
confidence to his readers !

Regards

José

Re: Date problem

Tobias Heinlein — 2013-02-27T13:42:38

Hi,

On 27.02.2013 07:26, José Fournier wrote:

Yes, the version and date tags of the file you mentioned
(hb-install-x86+amd64-medium.xml) are identical. But if you append
"&passthru" to the URL, e.g. :

http://www.gentoo.org/doc/en/handbook/handbook-amd64.xml?part=1&chap=2&passthru

you can see that there are other files involved as well. The XML code
you get there is from doc/en/handbook/handbook-amd64.xml which has
<date>2013-02-11</date>. That's the date the warning talks about.

You get the warning because doc/fr/handbook/handbook-amd64.xml wasn't
updated yet: It has <date>2010-07-19</date>. However, the date displayed
on the french webpage is indeed the date from
doc/fr/handbook/hb-install-x86+amd64-medium.xml. I suppose the date that
appears on the rendered page is the newest one of the dates of all the
files that are involved, thus ensuring that *every* part is updated.

Regards,
Tobias