Bug 417118 - Consider making common profile for "build-docs"
Summary: Consider making common profile for "build-docs"
Status: NEW
Alias: None
Product: Platform
Classification: Eclipse Project
Component: Doc (show other bugs)
Version: 4.3   Edit
Hardware: PC Linux
: P3 enhancement (vote)
Target Milestone: ---   Edit
Assignee: Platform-Doc-Inbox CLA
QA Contact:
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2013-09-12 12:25 EDT by David Williams CLA
Modified: 2013-09-12 12:25 EDT (History)
0 users

See Also:


Attachments
zip of only profiles invovled in makeing docs (5.54 KB, application/x-zip-compressed)
2013-09-12 12:25 EDT, David Williams CLA
no flags Details

Note You need to log in before you can comment on or make changes to this bug.
Description David Williams CLA 2013-09-12 12:25:36 EDT
Created attachment 235436 [details]
zip of only profiles invovled in makeing docs

While investigating 415008 I noticed each "doc bundle" has its own "build-docs" profile. 

And they are each slightly different. 

Ideally there would be just one profile, say in repo root pom, and everything "controlled" in one place. 

But, since slight differences, will take some study to know if they can be the same, or what the purpose of those differences are. (My guess is, it is related to "order of building the docs" or similar. But, one way or another, it looks a little kludgy. 

Difference might also be related to the fact that we use maven-dependency-plugin here to "copy" a bunch of stuff just so its "in the right place" that buildDoc.xml expects it to be in ... there's got to be a better way :) 

Counting as enhancement since doesn't cause a problem, as is, but just makes maintenance and future changes more complicated. 

Also, note, the current set up may be (part of) what contributes to "monolithic" build ... for example, ideally we'd be able to build low level equinox, p2, or platform, and still have "docs" for them ... without "building everything" just to get the docs. 

For easy reference, I'll attach a zip that has just the "build-docs" profiles in them (as p.xml files) ... just for easier comparisons ... and this was from 9/12/21013 ... i'm sure by the time changes are made, things will have changed, even if in some small ways.