Maven 2.x and 3.x Site Plugin

make site reactor aware

Details

  • Type: Bug Bug
  • Status: Closed Closed
  • Priority: Blocker Blocker
  • Resolution: Fixed
  • Affects Version/s: None
  • Fix Version/s: 2.0-beta-5
  • Component/s: None
  • Labels:
    None
  • Number of attachments :
    0

Description

there are a few things I'd like to do to make the sites more workable:

  • it's good they can still build independantly
  • however, if built from the parent, it would be good to go into aggregation mode and pull in those separately built sites, do any dashboards and deploy together
  • some reports would aggregate themselves, as well as participate in the dashboards (eg javadoc)
  • I'd like the navigation to behave hierachically (sections of the parent navigation marked as inherited remain on the child sites)
  • this means that when building from independant projects they'd need to be able to locate the parent site descriptor. This could be tricky without a USD - should it fail if it is not a USD, or should the site descriptor be published/referenced externally somehow?

Issue Links

is related to

Bug - A problem which impairs or prevents the functions of the product. MSITE-54 In parent site, automatically create link to modules sites and vice-versa

  • Minor - Minor loss of function, or other problem where easy workaround is present.
  • Closed - The issue is considered finished, the resolution is correct. Issues which are not closed can be reopened.

Activity

Ascending order - Click to sort in descending order
Brett Porter made changes -
Field Original Value New Value
Priority Major [ 3 ] Blocker [ 1 ]
Brett Porter made changes -
Fix Version/s 2.0-beta-2 [ 11861 ]
Environment
Fix Version/s 2.0-beta-1 [ 11040 ]
Description there are a few things I'd like to do to make the sites more workable:
- it's good they can still build independantly
- however, if built from the parent, it would be good to go into aggregation mode and pull in those separately built sites, do any dashboards and deploy together
- some reports would aggregate themselves, as well as participate in the dashboards (eg javadoc)
- I'd like the navigation to behave hierachically (sections of the parent navigation marked as inherited remain on the child sites)
- this means that when building from independant projects they'd need to be able to locate the parent site descriptor. This could be tricky without a USD - should it fail if it is not a USD, or should the site descriptor be published/referenced externally somehow?
 there are a few things I'd like to do to make the sites more workable:
- it's good they can still build independantly
- however, if built from the parent, it would be good to go into aggregation mode and pull in those separately built sites, do any dashboards and deploy together
- some reports would aggregate themselves, as well as participate in the dashboards (eg javadoc)
- I'd like the navigation to behave hierachically (sections of the parent navigation marked as inherited remain on the child sites)
- this means that when building from independant projects they'd need to be able to locate the parent site descriptor. This could be tricky without a USD - should it fail if it is not a USD, or should the site descriptor be published/referenced externally somehow?
Brett Porter made changes -
Link This issue is related to MNG-661 [ MNG-661 ]
Vincent Massol made changes -
Workflow jira [ 34151 ] Maven [ 37051 ]
Brett Porter made changes -
Component/s maven-site-plugin [ 11802 ]
Component/s maven-plugins [ 11380 ]
Brett Porter made changes -
Fix Version/s 2.0-beta-2 [ 11861 ]
Fix Version/s 2.0-beta-3 [ 12015 ]
Hide
Permalink
John Casey added a comment -

I'm willing to take this one on, but I'm not sure how we're approaching dashboards and/or aggregation of report results. Does each report have the option to aggregate itself, or run as an aggregator itself? If so, would they be knocked out of the site-driven aggregation? Do we have a single dashboard plugin that we're developing, or is that a generic term?

Also, would we be performing a merge of site descriptors, as in nesting sub-project site.xml contents under a menu item in the parent? Does it make sense to attach the site.xml as an attached artifact and manage parent references using artifact resolution?

Sorry to throw out so many questions, but this is not a side of maven I've ever used much (not even in m1), so if I'm going to get this one fixed myself, I'll need some help.

Show
John Casey added a comment - I'm willing to take this one on, but I'm not sure how we're approaching dashboards and/or aggregation of report results. Does each report have the option to aggregate itself, or run as an aggregator itself? If so, would they be knocked out of the site-driven aggregation? Do we have a single dashboard plugin that we're developing, or is that a generic term? Also, would we be performing a merge of site descriptors, as in nesting sub-project site.xml contents under a menu item in the parent? Does it make sense to attach the site.xml as an attached artifact and manage parent references using artifact resolution? Sorry to throw out so many questions, but this is not a side of maven I've ever used much (not even in m1), so if I'm going to get this one fixed myself, I'll need some help.
John Casey made changes -
Assignee John Casey [ jdcasey ]
Hide
Permalink
Brett Porter added a comment -

I was thinking of holding this over until post-2.0 and discussing it at greater length when the pressure is off.

Show
Brett Porter added a comment - I was thinking of holding this over until post-2.0 and discussing it at greater length when the pressure is off.
Hide
Permalink
John Casey added a comment -

Agreed. I'll reschedule for 2.1.

Show
John Casey added a comment - Agreed. I'll reschedule for 2.1.
John Casey made changes -
Assignee John Casey [ jdcasey ]
Fix Version/s 2.0-beta-3 [ 12015 ]
Fix Version/s 2.1 [ 11704 ]
Hide
Permalink
Fabrice Bellingard added a comment -

We're using site aggregation and dashboards of m1 widely in my company, and we want to switch from m1 to m2 ASAP though.
If maven 2.0 final release is to be "stable with a feature set comparable to Maven 1.0" - as we can read in announcements, don't you think those functionnalities should really be part of the 2.0 release? My development teams got used to dashboards of m1, and I guess they would be quite upset not to have it the final release of m2.
I perfectly understand that you have lots of things to do for final m2 though. I just wanted to share with you experiences and wishes of lots of Maven users of my company.

Show
Fabrice Bellingard added a comment - We're using site aggregation and dashboards of m1 widely in my company, and we want to switch from m1 to m2 ASAP though. If maven 2.0 final release is to be "stable with a feature set comparable to Maven 1.0" - as we can read in announcements, don't you think those functionnalities should really be part of the 2.0 release? My development teams got used to dashboards of m1, and I guess they would be quite upset not to have it the final release of m2. I perfectly understand that you have lots of things to do for final m2 though. I just wanted to share with you experiences and wishes of lots of Maven users of my company.
Hide
Permalink
Brett Porter added a comment -

m1 didn't have any site aggregation... the multiproject links are already in place - this is to make it smarter. The dashboard is a different case.

The statement about Maven is really meant to reflect on the feature set of the core, rather than availability of plugins. About 75% of them are at the same level as m1, but dashboard is not one of them.

Show
Brett Porter added a comment - m1 didn't have any site aggregation... the multiproject links are already in place - this is to make it smarter. The dashboard is a different case. The statement about Maven is really meant to reflect on the feature set of the core, rather than availability of plugins. About 75% of them are at the same level as m1, but dashboard is not one of them.
Jason van Zyl made changes -
Key MNG-384 MSITE-44
Affects Version/s 2.0-alpha-2 [ 11020 ]
Type Improvement [ 4 ] Bug [ 1 ]
Workflow Maven [ 37051 ] jira [ 44234 ]
Fix Version/s 2.1 [ 11704 ]
Component/s maven-site-plugin [ 11802 ]
Project Maven 2 [ 10500 ] Maven 2.x Site Plugin [ 11146 ]
Brett Porter made changes -
Assignee Brett Porter [ brettporter ]
Hide
Permalink
Brett Porter added a comment -

http://docs.codehaus.org/display/MAVEN/Sites+and+Inheritence

Show
Brett Porter added a comment - http://docs.codehaus.org/display/MAVEN/Sites+and+Inheritence
Brett Porter made changes -
Remaining Estimate 8 hours [ 28800 ]
Fix Version/s 2.0 [ 12151 ]
Original Estimate 8 hours [ 28800 ]
Permalink
Brett Porter logged work - 20/Dec/05 7:54 PM
  • Time Spent:
    4 hours
     
    <No comment>
Brett Porter made changes -
Time Spent 4 hours [ 14400 ]
Remaining Estimate 8 hours [ 28800 ] 4 hours [ 14400 ]
Brett Porter made changes -
Status Open [ 1 ] In Progress [ 3 ]
Permalink
Brett Porter logged work - 21/Dec/05 7:41 AM
  • Time Spent:
    4 hours
     
    did some work to replace use of DOM with a proper model. This simplifies the velocity template, albeit breaking backwards compat (the site plugin is still in "beta"). It also allows the generation of an XSD and possible validation of the model.
Brett Porter made changes -
Time Spent 4 hours [ 14400 ] 8 hours [ 28800 ]
Permalink
Brett Porter logged work - 22/Dec/05 10:39 PM
  • Time Spent:
    4 hours
     
    complete inheritence work
Brett Porter made changes -
Time Spent 8 hours [ 28800 ] 12 hours [ 43200 ]
Remaining Estimate 4 hours [ 14400 ] 1 hour [ 3600 ]
Permalink
Brett Porter logged work - 22/Dec/05 10:41 PM
  • Time Spent:
    4 hours
     
    unit tests and resolve paths against base url
Brett Porter made changes -
Remaining Estimate 1 hour [ 3600 ] 0 minutes [ 0 ]
Time Spent 12 hours [ 43200 ] 16 hours [ 57600 ]
Brett Porter made changes -
Status In Progress [ 3 ] Closed [ 6 ]
Resolution Fixed [ 1 ]
Jason van Zyl made changes -
Workflow jira [ 44234 ] Maven [ 45031 ]
Brett Porter made changes -
Workflow Maven [ 45031 ] Maven New [ 52403 ]
Brett Porter made changes -
Fix Version/s 2.0 [ 12151 ]
Fix Version/s 2.0-beta-5 [ 12541 ]

People

  • Assignee:
    Brett Porter
    Reporter:
    Brett Porter
Vote (4)
Watch (4)

Dates

  • Created:
    Updated:
    Resolved:

Time Tracking

Estimated:
8h
Original Estimate - 8 hours Original Estimate - 8 hours
Remaining:
0m
Remaining Estimate - 0 minutes
Logged:
16h
Time Spent - 16 hours