On 22.12.2006 19:58:43 Simon Pepping wrote:
> On Fri, Dec 22, 2006 at 05:38:52PM +0100, Vincent Hennebert wrote:
> > Guys,
> > 
> > Reading the release notes page is a bit disappointing I think:
> > "Hey, they made a new release! Let's look at the changes:
> > ok, bug fixes and new features.
> > Hmmm, the behaviour may change from 0.20.5.
> > Arghhh, what's that whole list of issues!!"
> > 
> > I doubt any normal user will have a look at the detailed changes (I'm
> > not saying the changes page is useless!).
> 
> I agree. Note that the forrest sitemap.xmap contains a rule for
> releaseNotes.xml and a stylesheet releaseNotes2document.xsl to
> generate that from the status.xml document (i.e. the change
> list). Maybe it would be a good idea to reinstate that document and
> relegate the known issues to a separate document? But it should be
> possible to have a separately written introduction and a list of
> important changes above the transformed list of changes.

I agree. Everything that makes a release easier to build is worth
looking into. Check out knownissues.xml for an idea (using XInclude,
scroll all the way down). Cocoon is very powerful.

> > What about listing the major improvements in the new release? The things
> > that will catch the eye of the normal user?
> > I've attached a small patch to relnotes.xml, so you see what I mean.
> 
> Good points.
> 
> Simon
> 
> > Index: relnotes.xml
> > ===================================================================
> > --- relnotes.xml    (r??vision 489680)
> > +++ relnotes.xml    (copie de travail)
> > @@ -34,7 +34,13 @@
> >      </li>
> >      <li>
> >        This release again contains many bug fixes and new features. See
> > -      the <a href="changes.html">changes file</a> for details.
> > +      the <a href="changes.html">changes file</a> for details. Most 
> > important
> > +      changes:
> > +      <ul>
> > +        <li>basic support for OpenType fonts</li>
> > +        <li>copy/paste from PDF files is now working</li>
> > +        <li>support for cmyk colors</li>
> > +      </ul>
> >      </li>
> >      <li>
> >        See the <a href="compliance.html">compliance page</a> for an
> 
> 
> -- 
> Simon Pepping
> home page: http://www.leverkruid.eu



Jeremias Maerki

Reply via email to