Seems every one is silent as you need to feel it to know the problem :). Anyway another point I'd like to raise here.
As I mentioned earlier, maven2 requires documents to be in either xodcs format or apt format to be tightly integrated in to the site generated. But if we convert all the docs to this format, then we can not include the docs inside the binary release, as user can not read apt or xdocs. To make users to read the docs in the release, we can make the docs in to html. But in that case those docs will not be properly integrated, when we generate the site. What can we do for this? The only option available for me now is to exclude docs in the distribution :(. Thanks, Chinthaka Eran Chinthaka wrote: > Hi, > > I had little bit of trouble, this time than any of the previous times, > while releasing Axiom. > > It could have been better if the maven 1 to maven 2 migration was > completed before the release. In Axiom we release two artifacts (binary > and source) and I wrote two scripts for it, using maven1. But these were > not converted (AFAIK, I do not know if there are any as there were no > documentation). Since the folder structure was changed significantly > most of the scripts found in maven.xml were not working. > > So when I was trying to release I couldn't use maven1 or maven2 for it, > which made me to waste extra time to fix the maven.xml. > > Then came problems with site generation. For that, since maven2 > structure enables resources in different folders (apt, resources, xdoc), > it was difficult to change maven1 to generate the site. And maven2 > didn't support plain htmls to be put in the site. Meaning, if I put an > html, it will just show it without formatting them or adding left pane > and applying maven templates. If that has to happen, all the docs should > be converted either to apt or xdoc format. This would have been worse if > this happened during an Axis2 release as it has lots of documents. > > Please do not take this as a blame. I also like the movement from maven1 > to maven2, which has advantages like faster builds, etc., > (FYI : Build time in Axiom is now 33 seconds with maven2 vs 1 min and 18 > sec with maven1. And I can observe tests are running extremely fast) > > But we must make sure we can do everything we did with maven1 also to be > done with maven2. Mind you, Axis2 has lots of scripts written in > maven.xmls in different places. I'd prefer if these are also converted > at once when the conversion happens. > > So this is what I prefer to see when the conversion happens, in addition > to the pom.xml and changed folder structure: > > 1. converting or making sure *all* the documents are properly published > whilst generating the site > 2. make sure *all* the scripts are working > > Thanks, > Eran Chinthaka >
signature.asc
Description: OpenPGP digital signature
