[darcs-users] Ideal authorsfile syntax and semantics.

Trent W. Buck trentbuck at gmail.com
Sun Mar 15 09:56:27 UTC 2009

Simon Michael <simon at joyful.com> writes:

> Trent W. Buck wrote:
>> Hmm, I'm not sure how much simpler I can make it, short of translating
>> the ABNF descriptions in RFC 2822 into English approximations.
> Aha! Good hint that the design is not yet right!
> I don't mean to be annoying. :-)

No worries.

> I really am interested in using (real, end-user-targeted)
> documentation to force the discovery of more elegant, lower-cost
> designs.

I'm not sure that "easy to explain" is (by itself) a reliable metric of
"goodness".  I mean, by analogy, it's a lot easier to explain
trepanation than anticonvulsants to a patient, but the latter will
probably be a better treatment for epilepsy.

More information about the darcs-users mailing list