--- Rick Hillegas <[EMAIL PROTECTED]> wrote:
> Daniel John Debrunner wrote: > > >Rick Hillegas wrote: > > > > > > > >>Jean T. Anderson wrote: > >> > >> > >> > >>>Rick Hillegas wrote: > >>> > >>> > >>> > >>> > >>>>Thanks, Jean. The Edition line turns up in the > visible text which > >>>>appears in the printed document. That makes me > think that it applies to > >>>>something that the customer, the reader, cares > about. I don't think the > >>>>reader is particularly concerned about our > transition to dita. If that > >>>>is what Edition is supposed to capture, perhaps > the Edition lines should > >>>>be moved to a comments section so that they will > not be > >>>>visible/confusing to customers. > >>>> > >>>> > >>>> > >>>The Developers Guide has a "first edition" for > both 10.0 and 10.1: > >>> > http://db.apache.org/derby/docs/10.0/manuals/develop/develop.html > >>> > http://db.apache.org/derby/docs/10.1/devguide/rdevcopyright.html > >>> > >>>I don't know why the Edition was bumped for the > others. :-) > >>> > >>>If there isn't a major change to the content of > the book, I don't think > >>>the edition should be bumped. > >>> > >>>"Working With Derby" should definitely not be > bumped from First to > >>>Second edition since 10.2 will be its first > release. > >>> > >>> > >>> > >>> > >>I could just bump the edition for the Reference > Guide, which will carry > >>a lot of edits to reflect JDBC4. Would that be > acceptable? > >> > >> > > > >What does the "edition" represent? Would this mean > the first release of > >the 10.2 documentation set would be partially at > the "second edition", > >doesn't seem to make sense to me. > > > >Dan. > > > > > This is what's troubling me too. From Jean's > investigations it seems > that "edition" doesn't have a consistent meaning > across our user guides > and releases. We could just remove the "edition" > lines. If we leave them > in, then it would be good to agree on their meaning. > Maybe one of the > following: > > 1) The Edition number is bumped whenever we create a > release branch. We > don't bump Edition for point or patch releases. > > 2) The Edition number is bumped whenever reviewers > agree that a user > guide has changed significantly. > > 3) The Edition number is the same as the release > number. All user guides > in a given release have identical Edition numbers. > > > As the person who contributed the DITA-converted documentation, I can tell you I didn't bump the edition up based on that. I believe the pre-DITA documentation already said Second Edition. The thought is that major releases (10.0, 10.1, 10.2) are First Editions, and subsequent fixpaks are Second, Third, Fourth editions etc., like 10.1.3 would be. In any case, we haven't adhered to any kind of consistency on this with the guides, so I agree that we need to define what we feel is an "edition" and stick with it or remove it alltogether (although perhaps there's a legal reason to keep it?) __________________________________________________ Do You Yahoo!? Tired of spam? Yahoo! Mail has the best spam protection around http://mail.yahoo.com