WTP Help build

classic Classic list List threaded Threaded
2 messages Options
Reply | Threaded
Open this post in threaded view
|

WTP Help build

Lawrence Mandel

Last week on the PMC call it was decided to separate the WTP help build from the regular build. This separation has a couple benefits.

1. It decouples the help doc schedule from the regular schedule. Help docs necessarily have to be finished later in the cycle. This will allow the help docs to be updated without compromising the WTP build.

2. A separate help build will allow the WTP to easily provide an update to the WTP help after releases including 0.7.

In order to separate the WTP help build the doc maps will need to be removed from the build and a separate build process will need to be setup based on these maps. All of the WTP help doc plugins are located in the two maps jst-doc.map and wst-doc.map.

Naci - Please remove these maps from the main WTP build. Is removing them as easy as deleting them?

We will need to discuss the best way to setup a separate WTP help build. With the separation of releng and releng.builder it may be as easy as creating a releng.help folder that contains the maps and adding a help-doc target to releng.builder that simply runs the regular build with no testing.

Lawrence Mandel

Software Developer
IBM Rational Software
Phone: 905 - 413 - 3814   Fax: 905 - 413 - 4920
[hidden email]

_______________________________________________
wtp-releng mailing list
[hidden email]
https://dev.eclipse.org/mailman/listinfo/wtp-releng
Reply | Threaded
Open this post in threaded view
|

Re: WTP Help build

Naci Dai
Lawrence Mandel wrote:

>
> Last week on the PMC call it was decided to separate the WTP help
> build from the regular build. This separation has a couple benefits.
>
> 1. It decouples the help doc schedule from the regular schedule. Help
> docs necessarily have to be finished later in the cycle. This will
> allow the help docs to be updated without compromising the WTP build.
>
> 2. A separate help build will allow the WTP to easily provide an
> update to the WTP help after releases including 0.7.
>
> In order to separate the WTP help build the doc maps will need to be
> removed from the build and a separate build process will need to be
> setup based on these maps. All of the WTP help doc plugins are located
> in the two maps jst-doc.map and wst-doc.map.
>
> Naci - Please remove these maps from the main WTP build. Is removing
> them as easy as deleting them?

We can re-organize the maps jst-doc, and wst-doc maps  under a different
folder  (how about releng/help?).  However, removing the maps does not
remove them from the build, but it surely will break the build :-)

The best way to refactor th ehelp build is to:

1) Design a new wtp-help feature that will create a help component from
these plugins.
2) Create a seperate help-build script that can be used to run
independent help builds. (And remove the corresponding ones from the
main scripts)
3) Add the help-build as a prerequisite of the main-build to the
build.cfg. We will use this tag to package a released version of the
help build with wtp builds.

>
> We will need to discuss the best way to setup a separate WTP help
> build. With the separation of releng and releng.builder it may be as
> easy as creating a releng.help folder that contains the maps and
> adding a help-doc target to releng.builder that simply runs the
> regular build with no testing.

My draft plan is to remove all specific targets from the main
releng.builder scripts, and use the main script to invoke targets from
new specific builders (i.e. invoke a releng.help target from help.xml)

>
> Lawrence Mandel
>
> Software Developer
> IBM Rational Software
> Phone: 905 - 413 - 3814   Fax: 905 - 413 - 4920
> [hidden email]
>
>------------------------------------------------------------------------
>
>_______________________________________________
>wtp-releng mailing list
>[hidden email]
>https://dev.eclipse.org/mailman/listinfo/wtp-releng
>  
>


--
Naci Dai,
eteration a.s.
Inonu cad. Sumer sok. Zitas D1-15
Kozyatagi, Istanbul 34742
+90 (533) 580 2393 (cell)
+90 (216) 361 5434 (phone)
+90 (216) 361 2034 (fax)
http://www.eteration.com/
mailto:[hidden email]
mailto:[hidden email]

_______________________________________________
wtp-releng mailing list
[hidden email]
https://dev.eclipse.org/mailman/listinfo/wtp-releng