spf-discuss
[Top] [All Lists]

Re: Can somebody create a consolidated, incremental changelog?

2005-05-08 11:55:26
In <200505081937(_dot_)40299(_dot_)bulk(_at_)mehnle(_dot_)net> Julian Mehnle 
<bulk(_at_)mehnle(_dot_)net> writes:

Wayne, thanks for collecting all those changelogs.

Someone (not me, and probably not Wayne) should create consolidated 
changelogs from each of the past major spec revisions (spf-draft-200406, 
draft-mengwong-spf-00, draft-mengwong-spf-01, draft-lentczner-spf-00, and 
draft-schlitt-spf-classic-00) to draft-schlitt-spf-classic-01.  Only 
significant changes in the protocol semantics should be mentioned.  These 
changelogs could probably be incremental for the most part.

This is something that I've been promising to do for a long time, but
haven't done it yet.  I may still do it, if I can find time.  It is
actually fairly high on my TODO list.

Some thoughts on the above request:

draft-mengwong-spf-01 and spf-draft-200406 are almost identical.  The
differences are:
  * draft-mengwong-spf-01 has been paginated
  * draft-mengwong-spf-01 has a Table of Contents added
  * draft-mengwong-spf-01 has a s/it MUST be/the value MUST be/ in
    section 7.1
  * draft-mengwong-spf-01 has a s/Implementations MAY limit the
    number, but MUST support at least a value of 9./Implementations
    MUST support at least a value of 128, as that is the maximum number
    of labels in a domain name./ in section 7.1
  * draft-mengwong-spf-01 has the line "The folks on the SPAM-L
    mailing list." duplicated

I'm not sure that it is worth distinguishing between these two drafts.

I would recommend skipping draft-lentczner-spf-00.  It was fairly
short lived as a draft goes, and much of the work done on the later
schlitt-spf-classic drafts are in the form of "restore <foo> from
draft-mengwong-spf-01".  I see it as a fork in the development of SPF
draft specs, as far as the semantics goes.  The wordsmithing that
MarkL did, however, was very useful.


Due to the massive rewriting that MarkL and I have done, comparing
draft-mengwong-spf-0[01] and spf-schlitt-01 will be very hard.  I
think a diff in any form will be nearly useless.

My plan to create a change log is as follows:

1) Go over each sentence/paragraph in draft-mengwon-spf-01 and see if
   I can locate equivalent language in draft-spf-schlitt-01.

2) Go over each sentence/paragraph in draft-spf-schlitt-01 and see if
   I can locate equivalent language in draft-mengwon-spf-01.

3) See if these two lists contain similar stuff because I missed
   something in one of the passes.

4) distill the list down to the really important semantic changes




I'm working on a change log for draft-mengwong-00 vs draft-mengwong-01
right now, I don't think it is too big.  I'll post it when I get done.


-wayne