Doxia Release Plan

This is a proposed release plan for Doxia and related pieces of Maven software.

Action	Developers	Date completed	Comments
Release 1.0-alpha-11 of Doxia, from the alpha branch	dennisl	2008-05-20
Update Site Plugin to use 1.0-alpha-11 of Doxia	dennisl	2008-05-20
Update PIR Plugin to use 1.0-alpha-11 of Doxia	dennisl	2008-05-20
Move the unresolved issues slated for 2.0-beta-7 to 2.0-beta-8 or later	dennisl	2008-05-20
Release version 1.0 of maven-doxia-tools, a shared component	vsiveton	2008-05-29
Use maven-doxia-tools 1.0 in the Site Plugin	dennisl	2008-05-29
Use maven-doxia-tools 1.0 in the PIR Plugin	vsiveton	2008-05-29
Release version 1.0.1 of maven-doxia-tools	dennisl	2008-06-14
Use maven-doxia-tools 1.0.1 in the Site Plugin	dennisl	2008-06-14
Use maven-doxia-tools 1.0.1 in the PIR Plugin	dennisl	2008-06-14
Release Site Plugin 2.0-beta-7, to avoid having too large releases	dennisl	2008-07-02
Release PIR Plugin 2.1	vsiveton	2008-07-28
Release Doxia 1.0	dennisl
Update maven-doxia-tools to use Doxia 1.0	dennisl
Release version 1.0.2 of maven-doxia-tools	dennisl
Update Site Plugin to use Doxia 1.0	dennisl
Update Site Plugin to use maven-doxia-tools 1.0.2	dennisl
Release Site Plugin 2.0	dennisl
Update PIR Plugin to use Doxia 1.0
Release PIR Plugin 2.2
Update Maven 2.0.x to use Doxia 1.0
Switch the Site Plugin (2.1-SNAPSHOT) to use Doxia 1.1-SNAPSHOT	ltheussl
Switch the PIR Plugin (2.3-SNAPSHOT) to use Doxia 1.1-SNAPSHOT	vsiveton
Release Doxia 1.1	ltheussl
Come up with a way to handle MNG-3402			Need to release Maven-2.1, see discussion
Release maven-reporting-impl 2.1 using Doxia 1.1	ltheussl
Release maven-doxia-tools 1.1 using Doxia 1.1	ltheussl
Release Site Plugin 2.1 using Doxia 1.1	dennisl
Release PIR Plugin 2.3 using Doxia 1.1	vsiveton
Start collecting a list of issues that blocks a Doxia 1.2 release	ltheussl
Push that list down to 0	ltheussl
Release Doxia 1.2	vsiveton

Feel free to attach your name to any of the actions above, if you are able to help with them.

sorting out Maven dependencies on Doxia

As seen in MNG-3402, Maven distributes a doxia-sink-api copy in its uber-jar: this is the main dependency between Maven and Doxia. Every API change in doxia-sink-api needs to be included in a Maven version before it can be used in a plugin (setting this Maven's version as prerequisite).

There are other more subtle dependencies in miscellaneous parts of Maven.

Doxia: doxia-sink-api

interface org.apache.maven.doxia.sink.Sink (since 1.0-alpha-6, no API change until 1.0-alpha-11)

deprecated interface org.codehaus.doxia.sink.Sink extends o.a.m.d.s.Sink (since 1.0-alpha-7)

interface org.apache.maven.doxia.sink.SinkFactory (since 1.0-alpha-9)

Maven Components: reporting-api

interface org.apache.maven.reporting.MavenReport#generate(org.codehaus.doxia.sink.Sink, Locale)

interface org.apache.maven.reporting.MavenMultiPageReport extends MavenReport (since Maven 3.0)
#generate(org.apache.maven.doxia.sink.Sink, SinkFactory, Locale)

Maven [2.0.2;2.0.7] depends on doxia-sink-api 1.0-alpha-7
Maven 2.0.8 depends on doxia-sink-api 1.0-alpha-9
Maven 2.0.9 depends on doxia-sink-api 1.0-alpha-10, equivalent to alpha-9
Maven 2.0.10-RC depends on doxia-sink-api 1.0-alpha-11, equivalent to alpha-9

Maven Shared: reporting-impl

abstract class org.apache.maven.reporting.AbstractMavenReport implements MavenReport
#generate(org.apache.maven.doxia.sink.Sink, SinkFactory, Locale)

Maven Plugins: maven-site-plugin

interface org.apache.maven.doxia.sink.SinkFactory (same as doxia-sink-api 1.0-alpha-9, to avoid Maven 2.0.8 as a prerequisite: see MSITE-368)

interface org.apache.maven.reporting.MavenMultiPageReport extends MavenReport (same as reporting-api 3.0, to avoid Maven 3.0 as a prerequisite)
#generate(org.apache.maven.doxia.sink.Sink, SinkFactory, Locale)