[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

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.

Hi Raphaël,

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,

-- 
Charles Plessy
Tsurumi, Kanagawa, Japan


Reply to: