Issue Details (XML | Word | Printable)

Key: MAVEN-556
Type: New Feature New Feature
Status: Closed Closed
Resolution: Won't Fix
Priority: Trivial Trivial
Assignee: Unassigned
Reporter: dion gillard
Votes: 0
Watchers: 1
Operations

If you were logged in you would be able to see more operations.
Maven 1

Roadmap doc plugin

Created: 09/Jul/03 12:10 AM   Updated: 28/Nov/08 06:13 AM   Resolved: 16/May/05 12:21 AM
Component/s: documentation
Affects Version/s: None
Fix Version/s: None

Time Tracking:
Not Specified

File Attachments: 1. Text File changes-project.xml.patch (0.8 kB)
2. Zip Archive changes.zip (3 kB)
3. Text File plugin.jelly.patch (1 kB)
4. Zip Archive roadmap.zip (5 kB)



 Description  « Hide

Hi,
would anyone be interested in a plugin which
generates a project roadmap?

This would be a simple report, linked from the
Project Documentation nav menu, and have sections
including:
. release version
. estimated release date
. line items including:
. functionality type (addition, change etc)
. description
. assigned developer

I would expect it to be very similar to the changes
plugin, and be generated by the inclusion of a roadmap.xml
file in the xdocs directory, e.g:

<document>
<body>
<release version="0.6" date="10-10-2003">
<action dev="tima" type="update">
Refactor administration UI.
</action>
...
</release>

<release version="0.7" date="Q1 2004">
....
</release>

<future>
<action dev="unassigned" type="add">
Add clustering support, based on javagroups.
</action>
</future>
</body>
</document>

Thoughts?

-Tim



Tim Anderson added a comment - 09/Jul/03 10:02 AM

initial cut of the roadmap plugin.


Emmanuel Venisse added a comment - 09/Jul/03 11:22 AM

Can we add a status action (Done, In progress, To do, ...)?


Tim Anderson added a comment - 09/Jul/03 06:48 PM

In the initial cut, there is a status column.
See http://openjms.sourceforge.net/roadmap-report.html for an example.


Tim Anderson added a comment - 09/Jul/03 06:50 PM

patch to xdoc plugin.jelly to include the report in the default reports, and exclude roadmap.xml from being transformed as a user doc


Brett Porter added a comment - 09/Jul/03 06:58 PM

look great!

how about...
a) a legend for the types?
b) a release history for completed milestones (separate page or below the roadmap?) Just an identical transform, but based on a "completed" flag.
c) cvs tag and branch information (what it was tagged when it was released, what branch it is currently on if not HEAD, the last merge tag of that branch)


Brett Porter added a comment - 09/Jul/03 06:59 PM

sorry, I noticed in the issue you already have (b) - just didn't see it on the example page at openJMS


Tim Anderson added a comment - 09/Jul/03 07:13 PM

> how about...
> a) a legend for the types?
Could do. This plugin is basically pinched from the changes report and given the similar content, should have the same L&F.

I actually like the way jira does it tho - as an annotation on the type image. I also like jira's images too, although I suspect atlassian would object if I copied them

> c) cvs tag and branch information (what it was tagged
> when it was released, what branch it is currently
> on if not HEAD, the last merge tag of that branch)

I view the roadmap plugin as being a record of future releases. Past releases would be the domain of the changes report.


Brett Porter added a comment - 09/Jul/03 07:26 PM

I guess my comments apply to the changes report more than this then.

But I wonder whether it would be better to integrate the two? Otherwise you would probably find you'd just be cutting and pasting to changes through from roadmap once a release is made. Better just to have a flag and generate two different files isn't it? I think that is possible with the reports, but I'm not quite sure...

Either that, or the two reports use the same source file, transforming different sections of it.


Tim Anderson added a comment - 09/Jul/03 07:56 PM

Yes and no. Having both changes and roadmap in the one report means you lose the ability to add xdoc <section> elements which only apply to one.

And some cutting and pasting would be required anyway, in order to convert a roadmap element to a change element.


Brett Porter added a comment - 09/Jul/03 09:12 PM

I'm not sure what you mean about the xdoc section - why does it apply to only one? Are you referring to having one source file and two outputs or one source and one output?

As for the changing from roadmap to changes - I'm not sure why can't they be the same format? There is the same basic set of elements, a flag to say if it is future or past (or perhaps a different tag like your original schema), then other information that might be different, but just becomes an optional element in the XML (or in your original schema, can be a different sequence I guess).

What do you think? Maybe we could list out all the appropriate information for both reports and put together one source file format. I like the idea of producing two documents though.


Tim Anderson added a comment - 10/Jul/03 12:44 AM

Theoretically (meaning I haven't tried it, you can mix any xdoc element in the changes/roadmap reports, e.g:

<body>
<section name="Roadmap">
This document provides a tentative roadmap for
OpenJMS
</section>
...
<release version="...">
</release>
</body>

...supporting the above means that the changes/roadmap can't be in the same document, unless new tags are introduced e.g:
<body>
<roadmap>
<description>This document ...</description>
<release version="..."/>
</roadmap>
<changes>
<description>Release notes for OpenJMS</description>
<release version="..."/>
</changes>
</body>

Doesn't seem to be a lot of point to me. I think it would be easier to have 2 source documents.

I don't have any problem with the same plugin generating both reports - seems like a sensible approach.
I've started to modify the changes plugin along these lines, but I'm running into problems with jelly. Any objections to a rewrite in XSLT (which works)?


Tim Anderson added a comment - 11/Jul/03 09:46 AM

Rolls the roadmap plugin into the changes plugin. This replaces the previous patches.


dion gillard added a comment - 04/Aug/03 01:35 AM

Does the patch apply? And has it been tested?


dion gillard added a comment - 04/Aug/03 09:49 PM

Patch for project.xml to include xalan


dion gillard added a comment - 04/Aug/03 09:50 PM

Details from Tim:
The changes.zip file attached to the bugrep is the relevant patch.
It updates:
src/plugins-build/changes/plugin.properties
src/plugins-build/changes/plugin.jelly
src/plugins-build/xdoc/plugin.jelly
and adds:
src/plugins-build/changes/src/plugin-resources/changes.xsl

The changes.xsl replaces changes.jsl.

The only other change that needs to be made is to project.xml,
to add xalan (see attached). Forgot to add this as in beta 9 as I'd hacked
forehead.conf to workaround classloader problems. Beta 10 seems to
have resolved this.

The openjms website has both reports:

http://openjms.sourceforge.net/changes-report.html
http://openjms.sourceforge.net/roadmap-report.html

The changes report was generated to not include the dev column:

  1. Disable developer column in changes report
    maven.changes.include.dev=false
    Regards,

Tim


Tim Anderson added a comment - 29/Jan/04 06:20 PM

This issue can be closed. The patch is out of date with respect to the changes plugin in RC1.


Brett Porter added a comment - 16/May/05 12:21 AM

reporter asked for it to be closed.


Rodrigo Vega added a comment - 28/Nov/08 06:13 AM

Sorry to comment in a very old thread, but i'm looking for a plugin to do exactly this. There is some one? I take a look to changes plugin but it doesn't have anymore the roadmap functionality in M2.

Can somebody point me to the right place?