OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: RE: [docbook] Policy on backwards incompatible changes

Norman's proposal sounds good to me. More than a year is a long time to
wait for making changes that break backward compatibility.

I think you could do away with the second rule altogether or make it
less stringent:

- The change was announced as part of the planning for the major

Assuming that a major release takes a few months to plan and implement,
you'd still give people a pretty big window to plan for the change.

That also relieves the burden of needing to put out a release simply to
announce a backwardly incompatible change. As written, if there is no
need to release an update prior to a major release, you'd be stuck
making a point release just to make the announcement.

-----Original Message-----
From: Jirka Kosek [mailto:jirka@kosek.cz] 
Sent: Wednesday, July 16, 2008 5:22 PM
To: Norman Walsh
Cc: docbook@lists.oasis-open.org
Subject: Re: [docbook] Policy on backwards incompatible changes

Norman Walsh wrote:

> After giving it some thought, the following proposal seems like 
> something I could live with:
> * A point release (X.1,X.2,X.1.2, etc.) MUST NOT contain any backwards
>   incompatible changes.
> * A major release MAY contain backwards incompatible changes if both
>   of the following conditions are true:
>   - The change was announced in the release notes for the previous 
>     version (major or minor)
>   - The change was announced in a release that occurred at least six
>     months previously.
> By these rules, we can announce, in V5.1, our plans to make a 
> backwards incompatible change in V6.0. Then, in V6.0, if it's been at 
> least six months since V5.1 was released, we can make the change.

This sounds perfectly reasonable to me.


   Jirka Kosek      e-mail: jirka@kosek.cz      http://xmlguru.cz
        Professional XML consulting and training services
   DocBook customization, custom XSLT/XSL-FO document processing
  OASIS DocBook TC member, W3C Invited Expert, ISO JTC1/SC34 member

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]