Re: [p2-dev] Doc reorg

[John Arthorne <John_Arthorne@xxxxxxxxxx>]

Separate pages is generally better in
the doc. It makes it easier to find the pages in the table of contents,
search results, etc. We should make them children of the task-focused section
names that Pascal added this morning (repo management, install management,
metadata generation).

Ian Bull <irbull@xxxxxxxxxxxxxxxxx>
Sent by: p2-dev-bounces@xxxxxxxxxxx

06/01/2009 01:16 PM

Please respond to
P2 developer discussions <p2-dev@xxxxxxxxxxx>

To	P2 developer discussions <p2-dev@xxxxxxxxxxx>
cc
Subject	Re: [p2-dev] Doc reorg

Andrew, I was just going to start on the features and
bundles & product publisher task.  :-).

I have reserved space for these in the p2_publisher.html.  Do you
want to put them there?  

If you apply the latest patch from:
248509: [doc] Provide documentation for p2 publisher bundle
https://bugs.eclipse.org/bugs/show_bug.cgi?id=248509

You will see the space I have reserved for these tasks.

cheers,
ian

On Mon, Jun 1, 2009 at 9:14 AM, Andrew Niefer <aniefer@xxxxxxxxxx>
wrote:

I have the following in my workspace, 
- ant tasks for managing p2 repos (includes p2.mirror, p2.repo2runnable,
p2.process.artifacts, and p2.composite.repository)
- ant tasks for publishing (currently includes p2.publish.featuresAndBundles,
p2.publish.product). 
These two pages are looking for a home 

I also have a separate pages for PDE/Build extensions to the publisher
which includes eclipse.publish.featuresAndBundles, eclipse.gatherBundle,
eclipse.gatherFeature, and eclipse.brand.p2.artifacts.


-Andrew

Pascal Rapicault/Ottawa/IBM@IBMCA
Sent by: p2-dev-bounces@xxxxxxxxxxx

06/01/2009 11:21 AM

Please respond to
P2 developer discussions <p2-dev@xxxxxxxxxxx>

To	P2 developer discussions <p2-dev@xxxxxxxxxxx>
cc	p2-dev@xxxxxxxxxxx, p2-dev-bounces@xxxxxxxxxxx
Subject	Re: [p2-dev] Doc reorg

I have released the new topic structure in topics_Guide.xml. 
Not all files referred to from here have been created yet.

Pascal
Rapicault---06/01/2009 10:45:07 AM---I'm proposing the perform the following
changes to the isv doc:

From:	Pascal Rapicault/Ottawa/IBM@IBMCA
To:	p2-dev@xxxxxxxxxxx
Date:	06/01/2009 10:45 AM
Subject:	[p2-dev] Doc reorg

---

I'm proposing the perform the following changes to the isv doc:
1) Reorganize the content of the "provisioning platform" section
into 4 subsections representing the "activities" people would
be interested in performing with p2:
- Managing an eclipse installation with the command line (to replace /
extend the "installing software using the p2 director application)
- Metadata generation (publisher, p2.inf, category generation)
- Repository management (including mirror, composite repo)
- Build integration (toRunnable, p2 map entry, product) in addition to
what is already in the PDE doc. 

2) Move the "provisioning platform (p2) subsection" as a top
level entry in the programmers guide
I will start on that reorg now, but please send feedback.

Also, we will have to review the Build related doc in the PDE doc to include/change
things like:
- Using repository as build input
- Review the section on ant scripts
- Review the section on packaging eclipse components
- Generate metadata from a 3.3 style product
- Reuse the SDK metadata (like it is described http://wiki.eclipse.org/Equinox/p2/Reusing_Platform_Metadata)
and give an example on how to rebrand the platform.


PaScaL_______________________________________________
p2-dev mailing list
p2-dev@xxxxxxxxxxx
https://dev.eclipse.org/mailman/listinfo/p2-dev

_______________________________________________
p2-dev mailing list
p2-dev@xxxxxxxxxxx
https://dev.eclipse.org/mailman/listinfo/p2-dev


_______________________________________________
p2-dev mailing list
p2-dev@xxxxxxxxxxx
https://dev.eclipse.org/mailman/listinfo/p2-dev




-- 
R. Ian Bull | EclipseSource Victoria | +1 250 477 7484
http://eclipsesource.com
| http://twitter.com/eclipsesource_______________________________________________
p2-dev mailing list
p2-dev@xxxxxxxxxxx
https://dev.eclipse.org/mailman/listinfo/p2-dev