From: Jonathan Nieder <jrnieder@gmail.com>
To: "Ævar Arnfjörð Bjarmason" <avarab@gmail.com>
Cc: Git Mailing List <git@vger.kernel.org>
Subject: Re: Where do I stick development documentation?
Date: Wed, 11 Aug 2010 21:39:22 -0500 [thread overview]
Message-ID: <20100812023922.GB19174@burratino> (raw)
In-Reply-To: <AANLkTi=dS1DYJ3MB-Du34sVPy8Qw8VNck=Lx54DtSfO0@mail.gmail.com>
Ævar Arnfjörð Bjarmason wrote:
> There's some documentation aimed at developing that I'd like to see /
> write in Git at some point.
>
> Developing:
>
> * How to work with Gettext
>
> * How to write portable code, i.e. constructs to avoid in C / shell
> script etc (these keep coming up).
Maybe:
Documentation/technical/api-gettext.txt
Documentation/CodingGuidelines
Documentation/PlatformNotes
or some variations on the theme?
> * How to deal with gettext / submit po files / keep them up to date
> etc.
gittranslation.7?
> * Core git concepts (that need to be translated), maybe I could
> adopt the gitglossary to this task, but it'd need to be a bit
> more structured, i.e. describe core data concepts first, then
> some other terms.
That sounds good. Once we develop infrastructure for translating
manpages, we could encourage translators to do gitglossary first
to standardize terminology.
> Actually, on that point, do we have documentation that describes
> git's data model in one place? I.e. everything from blobs to
> trees, how raw commit objects etc. look. Something like "Git for
> computer scientists".
Hopefully some pic wizard can convert that to nroff. :)
I think Tommi Virtanen should be easy to reach in case anyone wants to
try adapting the article somehow.
Hope that helps,
Jonathan
next prev parent reply other threads:[~2010-08-12 2:40 UTC|newest]
Thread overview: 11+ messages / expand[flat|nested] mbox.gz Atom feed top
2010-08-11 22:49 Where do I stick development documentation? Ævar Arnfjörð Bjarmason
2010-08-12 2:39 ` Jonathan Nieder [this message]
2010-08-12 3:11 ` Ævar Arnfjörð Bjarmason
2010-08-12 3:17 ` Low-level repository inspection (Re: Where do I stick development documentation?) Jonathan Nieder
2010-08-12 3:40 ` Ævar Arnfjörð Bjarmason
2010-08-12 3:57 ` Jonathan Nieder
2010-08-12 20:00 ` Where do I stick development documentation? Michael Witten
2010-08-12 20:08 ` Ævar Arnfjörð Bjarmason
2010-08-12 20:29 ` Jonathan Nieder
2010-08-12 20:33 ` Jonathan Nieder
2010-08-12 20:37 ` Ævar Arnfjörð Bjarmason
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: http://vger.kernel.org/majordomo-info.html
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20100812023922.GB19174@burratino \
--to=jrnieder@gmail.com \
--cc=avarab@gmail.com \
--cc=git@vger.kernel.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://80x24.org/mirrors/git.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).