threads / discuss / 51016

Contributing with documentation/translation

Subject: Contributing with documentation/translation

## tl;dr

4 messages between Apr 30, 2019 and May 5, 2019.

replies: 3people: 4as markdown or json

Duy Nguyen· May 1, 2019, 10:11 UTC · re: Priscila Gutierres · lore

Re: Contributing with documentation/translation

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

Jeff King· May 1, 2019, 20:35 UTC · re: Duy Nguyen · lore

Re: Contributing with documentation/translation

On Wed, May 01, 2019 at 05:11:38PM +0700, Duy Nguyen wrote:
Show 10 quoted lines
> 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
Jean-Noël AVILA· May 5, 2019, 16:31 UTC · re: Jeff King · lore

Re: Contributing with documentation/translation

On Wednesday, 1 May 2019 22:35:45 CEST Jeff King wrote:
Show 30 quoted lines
> 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

← back to recent threads