Re: doc: Italian translation

[Federico Vaga]

On Monday, 28 May 2018 15:08:28 CEST Jonathan Corbet wrote:
> On Sun, 27 May 2018 16:55:55 +0200
> 
> Federico Vaga <federico.vaga@xxxxxxxxxx> wrote:
> > here the doc-guide translated in Italian. This set of patches
> > includes some minor changes to the main one. The idea of this
> > first set of patches is also to adjust the structure and our
> > expectations.
> 
> I've only done a quick scan so far.  It looks reasonable, but I have
> a couple of requests:
> 
>  - Please include a proper changelog with each patch describing what
> the patch does and why.  Otherwise I'll have to fill them in, and
> that makes me grumpy...:)

Ok

>  - You might as well add a MAINTAINERS entry.  The other
> translations don't have them, but they should.

Ok

>  - For extra credit: it's time to move the translations out of the
>    top-level index into an index.rst in the translations directory. 
> Then the top-level file can have a single pointer to the
> translations.

I completely agree on this point. I can prepare a patch that does it.

> > We tried to translate everything in **Italian**; which means that
> > we avoided imported English words wherever there is the
> > possibility to use the Italian ones. Of course, this is not
> > always possible, or worst doing the translation make it less
> > clear, for example the word "file".
> 
> "We"?  Is there somebody else's work represented here too?  If so,
> they should appear in the signoff chain (or as a Co-developed-by
> credit).

I did, in patch 3/5 and 4/5 there is Alessia as "signed-off" (in CC 
here).

> > Another point. I noticed that the disclaimer for other
> > translations is in English, so I did the same. But actually
> > shouldn't be in Italian, since that page will be read by Italian
> > speakers?
> 
> Perhaps, though part of the idea is to give the English speakers,
> too, some vague clue of what they're looking at.

Make sense. I will keep it like this then.

Thanks

> 
> Thanks,
> 
> jon


-- 
Federico Vaga
http://www.federicovaga.it/