# Contributing with documentation/translation 4 messages from 2019-04-30 to 2019-05-05. Participants: Priscila Gutierres, Duy Nguyen, Jeff King, Jean-Noël AVILA. Thread: https://gitlist.dev/t/51016 ## Priscila Gutierres, 2019-04-30 18:09 Subject: Contributing with documentation/translation Message-ID: URL: https://gitlist.dev/e/CAHtYWY4g4BYDr_z7pfS-p%3DaX_YkVo4HzGR1Dsytn4RkzBo0GjA%40mail.gmail.com ``` Hi I want to contribute to git by creating and/or translating documentation. Where may I find the info to do this? Priscila. ``` ## Duy Nguyen, 2019-05-01 10:11 Subject: Re: Contributing with documentation/translation Message-ID: URL: https://gitlist.dev/e/CACsJy8DHH_PqZ9DQ5jpA_4AuLmVXmt3F3x6nYVGqZ1pNWnC5%2BQ%40mail.gmail.com In-Reply-To: ``` On Wed, May 1, 2019 at 1:10 AM Priscila Gutierres 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, 2019-05-01 20:35 Subject: Re: Contributing with documentation/translation Message-ID: <20190501203545.GA13372@sigill.intra.peff.net> URL: https://gitlist.dev/e/20190501203545.GA13372%40sigill.intra.peff.net In-Reply-To: ``` On Wed, May 01, 2019 at 05:11:38PM +0700, Duy Nguyen wrote: > On Wed, May 1, 2019 at 1:10 AM Priscila Gutierres > 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, 2019-05-05 16:31 Subject: Re: Contributing with documentation/translation Message-ID: <1637274.A4eT74VTMb@cayenne> URL: https://gitlist.dev/e/1637274.A4eT74VTMb%40cayenne In-Reply-To: <20190501203545.GA13372@sigill.intra.peff.net> ``` 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 > > 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 ```