Re: [Gwt-openlayers-devl] IMPORTANT merging maven enhancements (trac issue 48)

[Farrukh N. <fa...@we...>]

Hi Andrew,

The initial site docs look very nice. Thanks again for this valuable 
contribution.

On 08/24/2010 07:47 PM, Andrew Hughes wrote:
> Hi Farrukh,
>
> +1 for Jira :)
>
> *The maven site (documentation)...*
>
> It's early days, but I have deployed the tip/snapshot to sourceforge's 
> htdoc's (using mvn site site:deploy) so please take a look..
> http://gwt-openlayers.sourceforge.net/maven-site/
> http://gwt-openlayers.sourceforge.net/maven-site/apidocs/index.html (javadocs 
> too)
>
> If you have something add/fix/append/remove, please do so... you will 
> find the src under  ./src/site of each module.
>
>     * Site's are configured in ./src/site/site.xml. Including pages,
>       menu's layout e.t.c.
>     * Content can come from a few formats, and so far I've used APT
>       (almost plain text). You can see the pages in
>       ./src/site/apt/some-page.apt I recommend the apt qucik start
>       guide here
>       http://www.scottnesbitt.net/docs/apt_quick_ref.pdf (I'd also
>       recommend xdoc in some cases too, it's your call).
>
> Maven has really good doco about sites here: 
> http://maven.apache.org/plugins/maven-site-plugin/
>
> I don't believe the site will or should hold up a 0.5 release, as we 
> can release much more frequently in the future - but it would be nice 
> to see this documentation site evolve quickly. The community needs 
> good documentation :)
>
>
> On Tue, Aug 24, 2010 at 10:47 PM, Farrukh Najmi 
> <fa...@we... <mailto:fa...@we...>> 
> wrote:
>
>
>     +1 on the proposed resolution of issue 48:
>
>     https://sourceforge.net/apps/trac/gwt-openlayers/ticket/48
>
>     Kudos to Andrew for the terrific work to implement the proposed
>     resolution.
>     Kudos to Edwin and other dev team members for a lot of good work
>     leading
>     up to 0.5 release.
>
>     BTW, we should consider getting a free hosted JIRA license for the
>     project.
>     It would be so much better than TRAC. Lots of SF projects are
>     doing that
>     these days that SF should just get a blanket deal with Atlassian.
>
>
>     On 08/24/2010 07:43 AM, Edwin Commandeur wrote:
>     > Hi all,
>     >
>     > Andrew Hughes has been working hard to get things ready for a 0.5
>     > release. One open issue is merging Andrew's fantastic work to make
>     > proper use of Maven onto the default branch. You can check out the
>     > improvements and see the new project dir layout by cloning the
>     > 'trac_ticket_48' branch.
>     >
>     > PLEASE MAIL IT TO THE DEV LIST WITHIN 2 or 3 DAYS IF YOU WANT TO
>     GIVE
>     > FEEDBACK ON THE MERGE!!! If you are not okay with the merge then
>     > please provide arguments about the how and why.
>     >
>     > All in all we think is a huge win, so we hope you'll feel the
>     same way.
>     >
>     > There will be three modules in the new project structure:
>     > gwt-openlayers (parent)
>     > gwt-openlayers-client (what is now gwt-ol)
>     > gwt-openlayers-showcase
>     >
>     > After checking out the project you can simply import the modules for
>     > project into Eclipse as an existing Maven project (requires the
>     > m2eclipse plugin). The documentation will be updated to describe how
>     > to debug it all without the Google Eclipse Plugin and how to get the
>     > showcase to work with the Google Eclipse Plugin (should work
>     with new
>     > versions of GEP).
>     >
>     > Building the jar:
>     >
>     >> cd gwt-openlayers-client
>     >> mvn package (or mvn install)
>     >>
>     > Running the showcase:
>     >
>     >> cd gwt-openlayers-showcase
>     >> mvn gwt:run
>     >>
>     > Building the new website
>     >
>     >> cd gwt-openlayers
>     >> mvn site (requires mvn install of gwt-openlayers-client, to
>     also build JavaDoc and link it in site).
>     >>
>     > Eventually the proxy in gwt-openlayers-client will be moved to
>     > gwt-openlayers-server. This is in line with gwt-maven conventions.
>     >
>     > Building the project with Ant is no longer supported, as we want to
>     > focus on getting everyting right with Maven. Also, the project
>     website
>     > will be generated from Maven.
>

-- 
Regards,
Farrukh Najmi

Web: http://www.wellfleetsoftware.com