From: Ealdwulf Wuffinga <ealdwulf@googlemail.com>
Date: Fri, 15 May 2009 19:05:10 GMT
Subject: Re: Request for detailed documentation of git pack protocol
Message-ID: <efe2b6d70905151205r70a167a4kdc3575f4c0ec9574@mail.gmail.com>
In-Reply-To: <4A0CBE35.6030004@gmail.com>

On Fri, May 15, 2009 at 1:58 AM, A Large Angry SCM <gitzilla@gmail.com> wrote:

> Standardese, the peculiar dialect and formalism employed by RFC authors, is
> not difficult to master. The difficult part is writing the prose that's an
> _unambiguous_ description of the protocol you're attempting to document.
> There's even a tool, xml2rfc, that will do the formatting for you.

There are also tools for writing unambiguous prose:
http://en.wikipedia.org/wiki/Controlled_natural_language.
They look potentially tedious to use, but I haven't actually tried.

Ealdwulf