Re: RFC round 4: DEP-3: Patch Tagging Guidelines
Le Fri, Jul 24, 2009 at 01:14:16AM +0200, Raphael Hertzog a écrit :
> * Charles Plessy wanted to specify more precisely the format instead
> of saying "RFC-2822 compliant fields". The discussion went nowhere
> and nobody else expressed support for such a change.
my main concern is the discrepancy betwen the fact that the format does not
comply with RFC-2822, and the following sentence: “The meta-information would
be stored in a set of RFC-2822 compliant fields”.
It is you decision if the DEP needs to contain or not a precise description of
the format, but I would really recommend to soften the above sentence to make
it match the facts. How about:
The meta-information would be stored in a set of fields similar to the ones
used in RFC-2822.
I think that it is important for the newcommers that our documentation is
accurate and does not rely on obviousness that only comes with experience.
Have a nice day,
Tsurumi, Kanagawa, Japan