[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [List Home]
Re: [p2-dev] Doc reorg


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.

Inactive hide details for Pascal Rapicault---06/01/2009 10:45:07 AM---I'm proposing the perform the following changes to the isPascal 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