[stp-dev] Restructured STP help

["Porter, David" <David.Porter@xxxxxxxx>]

In a bid to encourage documentation contributions from the various STP sub-projects, we have restructured the online help (https://bugs.eclipse.org/bugs/show_bug.cgi?id=163091).

 

We now have an overall org.eclipse.stp.doc plugin that calls a number of new help plugins for each of the sub-projects.

 

The following help plugins have been created:

 

org.eclipse.stp.b2j.doc

org.eclipse.stp.bpmn.doc

org.eclipse.stp.core.doc

org.eclipse.stp.sc.doc

org.eclipse.stp.soas.doc

 

Currently, the only one that actually contains any documentation (and still fairly sparse at that) is the service creation help.

 

It seems that there is quite a lot of documentation floating about - on the various sub-project web sites, wikis, and even in the CVS repository - that is relevant to STP users. My feeling is that design specifications and discussions about the future direction of the tools should live on wikis. Instructions on how to actually use the tools should live in the help. Many other Eclipse projects also ship their Javadoc in their help plugins, so we might want to look at that too.

 

David