[
Date Prev][
Date Next][
Thread Prev][
Thread Next][
Date Index][
Thread Index]
[
List Home]
|
RE: [wtp-dev] Facet documentation
|
Sachin,
Rest assured that we all understand the importance of docs in making WTP
a viable platform for ISVs to build on. Now that the functional coding
is complete for M9, there should be more cycles available to dedicate to
documentation.
In the meantime, here is an example definition along with pointers to
relevant interface that you would need to implement.
<extension point="org.eclipse.wst.common.project.facet.core.facets">
<project-facet id="my.facet">
<label>My Facet</label>
<description>The description.</description>
</project-facet>
<project-facet-version facet="my.facet" version="1.0">
<constraint>
<and>
<requires facet="jst.web" version=">=2.3"/>
<requires facet="jst.java" version="1.4,5.0"/>
</and>
</constraint>
</project-facet-version>
<project-facet-version facet="my.facet" version="2.0">
<constraint>
<and>
<requires facet="jst.web" version="2.4"/>
<requires facet="jst.java" version="5.0"/>
</and>
</constraint>
</project-facet-version>
<action type="install" facet="my.facet" version="1.0,2.0">
<delegate
class="(see org.eclipse.wst.project.facet.core.IDelegate)"/>
<!-- Optional. Only needed if you want to gather user input. -->
<config-factory
class="(see org.eclipse.wst.project.facet.core.
IActionConfigFactory)"/>
</action>
</extension>
<extension point="org.eclipse.wst.common.project.facet.core.runtimes">
<!-- If you care to carefully control which runtimes you facet will
run
on do something like this: -->
<supported>
<runtime-component id="org.eclipse.jst.server.tomcat"
version="4.0"/>
<facet id="my.facet" version=">=1.0"/>
</supported>
<supported>
<runtime-component id="org.eclipse.jst.server.tomcat"
version="5.0"/>
<facet id="my.facet" version="2.0"/>
</supported>
<!-- Otherwise: -->
<supported>
<runtime-component any="true"/>
<facet id="my.facet" version="1.0,2.0"/>
</supported>
</extension>
<extension point="org.eclipse.wst.common.project.facet.ui.images">
<image facet="my.facet" path="icons/myicon.gif"/>
</extension>
<!-- Optional. Only needed if you want to gather user input. Make sure
to
define the config factory if you use this. -->
<extension point="org.eclipse.wst.common.project.facet.ui.wizard">
<wizard-pages facet="my.facet" version="1.0">
<install>
<page class="(see org.eclipse.wst.project.facet.ui.
IFacetWizardPage)"/>
</install>
</wizard-pages>
<wizard-pages facet="my.facet" version="2.0">
<install>
<page class="(see org.eclipse.wst.project.facet.ui.
IFacetWizardPage)"/>
</install>
</wizard-pages>
</extension>
-----Original Message-----
From: wtp-dev-bounces@xxxxxxxxxxx [mailto:wtp-dev-bounces@xxxxxxxxxxx]
On Behalf Of Sachin Patel
Sent: Wednesday, November 16, 2005 7:15 AM
To: General discussion of project-wide or architectural issues.
Subject: Re: [wtp-dev] Facet documentation
Hi all,
When could we expect an updated doc for the facet framework? Due to the
post ops no longer being invoked, I'm now highly dependent on creating
facets. However, the existing documentation is lacking basic info such
as what the extension point id's are nor does it have any concrete
examples I can go by.
Could someone point me to examples and I can use in the meantime?
On a side note, as much functional content and areas of extensibility
that is in WTP, I believe a large part of the success of WTP 1.0 will be
highly dependent on the amount of documentation that is provided for
developers. I think at minimum every extension point in WTP needs to be
listed and described in the help as well as examples provided for those
extension points. I think there is already a bugzilla open for this. I
hope the severity of it can be bumped up. Its important that we show the
community not only what function WTP provides out of the box, but even
more importantly how developers can exploit WTP as a framework and thus
stressing the importance of developer doc being available.
Thanks,
Sachin
Konstantin Komissarchik wrote:
>
> Jay,
>
> May apologies for not getting this updated sooner. Unfortunately I am
> still swamped with critical dev work as we are trying to wrap up the
> integration. Unless someone wants to step up and volunteer to update
> the doc, it will probably not be updated until next week. In the
> meantime, the only thing I can do is point you at the javadoc and the
> extension points schemas both of which are up-to-date.
>
> - Konstantin
>
>
------------------------------------------------------------------------
>
> *From:* wtp-dev-bounces@xxxxxxxxxxx
> [mailto:wtp-dev-bounces@xxxxxxxxxxx] *On Behalf Of *Jay Cagle
> *Sent:* Monday, November 07, 2005 7:59 AM
> *To:* Konstantin Komissarchik
> *Cc:* wtp-dev@xxxxxxxxxxx
> *Subject:* RE: [wtp-dev] Facet documentation
>
>
> Hi Konstantin,
>
> What is the ETA for getting the facet design doc updated?
>
(http://www.eclipse.org/webtools/development/proposals/Features%20Framew
ork%20Specification.htm)
>
>
> We have a lot of developers needing to build on top of it and our
> schedule is short for doing it, so it would really help to get this
> document updated.
>
> Thanks,
>
> Jay
>
> _____________________________________
> Jay Cagle
> Web RAD Tools Development Team Lead
> IBM Rational Application Developer
> (919) 254-6906 (t/l 444), jcagle@xxxxxxxxxx
>
> *"Konstantin Komissarchik" <kosta@xxxxxxx>*
> Sent by: wtp-dev-bounces@xxxxxxxxxxx
>
> 11/02/2005 12:06 PM
>
> Please respond to
> "General discussion of project-wide or architectural issues."
> <wtp-dev@xxxxxxxxxxx>
>
>
>
> To
>
>
>
> "General discussion of project-wide or architectural issues."
> <wtp-dev@xxxxxxxxxxx>
>
> cc
>
>
>
> Subject
>
>
>
> RE: [wtp-dev] Facet documentation
>
>
>
>
>
>
> The closest we have is this:
>
http://www.eclipse.org/webtools/development/proposals/Features%20Framewo
rk%20Specification.htm,
> which hasn't been updated in a while. I will try to get it updated in
> the next couple of days.
>
> We also need a transition doc that talks about api differences and
> what ISVs need to do to convert from 0.7 to 1.0. Does that already
> exist? If so, it would need a new section about converting to facets.
> Anyone wants to volunteer?
>
> I am also planning to write an article/tutorial about creating facets,
> but that's further out.
>
> - Konstantin
>
>
------------------------------------------------------------------------
>
>
> *From:* wtp-dev-bounces@xxxxxxxxxxx
> [mailto:wtp-dev-bounces@xxxxxxxxxxx] *On Behalf Of *Lawrence Mandel*
> Sent:* Tuesday, November 01, 2005 5:49 PM*
> To:* wtp-dev@xxxxxxxxxxx*
> Subject:* [wtp-dev] Facet documentation
>
>
> With facets part of M9 we need to have complete and up-to-date design
> documentation on project facets available for WTP extenders so they
> can react to these changes.
>
> Is this documentation already available? (I couldn't find it on the
> site.) If not, is there a plan to make this documentation available?
>
> Thanks,
>
> Lawrence Mandel
>
> Software Developer
> IBM Rational Software
> Phone: 905 - 413 - 3814 Fax: 905 - 413 - 4920
> lmandel@xxxxxxxxxx
>
>
------------------------------------------------------------------------
>
> _______________________________________________
> wtp-dev mailing list
> wtp-dev@xxxxxxxxxxx
> https://dev.eclipse.org/mailman/listinfo/wtp-dev
>
_______________________________________________
wtp-dev mailing list
wtp-dev@xxxxxxxxxxx
https://dev.eclipse.org/mailman/listinfo/wtp-dev
