Contributing with documentation/translation

Contributing with documentation/translation

[Priscila Gutierres]

Hi
I want to contribute to git by creating and/or translating
documentation. Where may I find the info to do this?

Priscila.

Re: Contributing with documentation/translation

[Duy Nguyen]

On Wed, May 1, 2019 at 1:10 AM Priscila Gutierres
<priscila.gutierres@gmail.com> wrote:
>
> Hi
> I want to contribute to git by creating and/or translating
> documentation. Where may I find the info to do this?

For translation, you could start at po/README. That's mostly UI
translation. I think some team actually started document translation
too [1], but I don't know the status.

For creating/updating documents in English, I think our documents can
use some improvements. Just pick one document under Documentation
directory, read it and see if you can understand it (if not we
probably need to rephrase or reorganize a bit, sometimes a lot). I'm
not so sure about creating new documents. That's usually done when a
new feature/command is added.

[1] The ground work for that seems done in 3d5b568f1a
(Documentation/Makefile add optional targets for l10n, 2019-01-07)

--
Duy

Re: Contributing with documentation/translation

[Jeff King]

On Wed, May 01, 2019 at 05:11:38PM +0700, Duy Nguyen wrote:

> On Wed, May 1, 2019 at 1:10 AM Priscila Gutierres
> <priscila.gutierres@gmail.com> wrote:
> >
> > Hi
> > I want to contribute to git by creating and/or translating
> > documentation. Where may I find the info to do this?
> 
> For translation, you could start at po/README. That's mostly UI
> translation. I think some team actually started document translation
> too [1], but I don't know the status.

+cc Jean-Noel, who is working on this. It looks like translations will
be done through Weblate:

  https://hosted.weblate.org/projects/git-manpages/translations/

There's some more discussion in:

  https://public-inbox.org/git/1992944.NOdEsaAZKb@cayenne/

There are also translations of the "Pro Git" book. This isn't strictly
"Git documentation", but it is CC-licensed and we show it on
git-scm.com. Details are at:

  https://github.com/progit/progit2/blob/master/TRANSLATING.md

-Peff

Re: Contributing with documentation/translation

[Jean-Noël AVILA]

On Wednesday, 1 May 2019 22:35:45 CEST Jeff King wrote:
> On Wed, May 01, 2019 at 05:11:38PM +0700, Duy Nguyen wrote:
> 
> > On Wed, May 1, 2019 at 1:10 AM Priscila Gutierres
> > <priscila.gutierres@gmail.com> wrote:
> > >
> > > Hi
> > > I want to contribute to git by creating and/or translating
> > > documentation. Where may I find the info to do this?
> > 
> > For translation, you could start at po/README. That's mostly UI
> > translation. I think some team actually started document translation
> > too [1], but I don't know the status.
> 
> +cc Jean-Noel, who is working on this. It looks like translations will
> be done through Weblate:
> 
>   https://hosted.weblate.org/projects/git-manpages/translations/
> 
> There's some more discussion in:
> 
>   https://public-inbox.org/git/1992944.NOdEsaAZKb@cayenne/
> 
> There are also translations of the "Pro Git" book. This isn't strictly
> "Git documentation", but it is CC-licensed and we show it on
> git-scm.com. Details are at:
> 
>   https://github.com/progit/progit2/blob/master/TRANSLATING.md
> 
> -Peff
> 

Hi Priscila,

Peff has said it all. Depending on where you are on you way to learning about git, I would recommend:

* Starting with Progit for a gentle introduction to using git
* Translating git manpages for extensive knowledge of all git commands
* Translating git itself for indepth knowledge of how git works

The translation teams are welcoming to new contributors.

----
Jean-Noël