Author: abogachuk
Date: 2010-05-05 10:42:46 -0400 (Wed, 05 May 2010)
New Revision: 21907
Modified:
trunk/drools/docs/guvnor_ref/en-US/conclusion.xml
trunk/drools/docs/guvnor_ref/en-US/functionality_overview.xml
trunk/drools/docs/guvnor_ref/en-US/guvnor_preferences.xml
trunk/drools/docs/guvnor_ref/en-US/introduction.xml
Log:
https://jira.jboss.org/jira/browse/TOOLSDOC-63 Eclipse Guvnor Tools Reference Guide
restructureing and update. The minor structure and text changes have been made.
Modified: trunk/drools/docs/guvnor_ref/en-US/conclusion.xml
===================================================================
--- trunk/drools/docs/guvnor_ref/en-US/conclusion.xml 2010-05-05 13:34:07 UTC (rev 21906)
+++ trunk/drools/docs/guvnor_ref/en-US/conclusion.xml 2010-05-05 14:42:46 UTC (rev 21907)
@@ -8,7 +8,7 @@
</keywordset>
</chapterinfo>
- <title>Conclusion</title>
+ <title>Summary</title>
<para>As stated at the beginning of this document, the key goal of the
<property>EGT</property>
is to provide a way of interacting with Guvnor repository resources in a local
Eclipse
@@ -18,7 +18,7 @@
<section>
<title>Other relevant resources on the topic</title>
-
+ <para>For more information visit the following resources:</para>
<itemizedlist>
<listitem>
<para>Guvnor <ulink
url="http://www.jboss.org/community/wiki/Guvnor">wiki
page</ulink></para>
Modified: trunk/drools/docs/guvnor_ref/en-US/functionality_overview.xml
===================================================================
--- trunk/drools/docs/guvnor_ref/en-US/functionality_overview.xml 2010-05-05 13:34:07 UTC
(rev 21906)
+++ trunk/drools/docs/guvnor_ref/en-US/functionality_overview.xml 2010-05-05 14:42:46 UTC
(rev 21907)
@@ -12,7 +12,7 @@
<para>This chapter will give an overview on all functionality the
<property>Guvnor Tools</property> provides.</para>
- <section > <!-- id="new_connection" -->
+ <section >
<title>Creating a New Guvnor Connection</title>
<para>As mentioned in the <link
linkend="introduction">"Introduction"</link>, the
main purpose
of the <property>EGT</property> is to allow development using
resources held in a Guvnor
@@ -85,74 +85,6 @@
repository, the location within the repository, the version (date/time stamp)
and
the revision number.</para>
</section>
-
- <section id="resources_from_guvnor">
- <title>Importing Guvnor Repository Resources</title>
-
- <para>In addition to the single file drag-and-drop from the
<property>Guvnor Repositories
- view</property>, the <property>EGT</property> also includes
a wizard for copying one
- or more files from a Guvnor repository to the local workspace (and setting
the
- association with the Guvnor repository). This wizard is available from the
<emphasis>
- <property>File > Import > Guvnor > Resource
from
- Guvnor</property>
- </emphasis> and the <emphasis>
- <property>File > New > Other > Guvnor >
Resource from
- Guvnor</property>
- </emphasis> menu items.</para>
- <note>
- <title>Note:</title>
-
- <para>Note that the wizard is identical but appears in both locations
to accommodate
- users who tend to view this functionality as being in either
category.</para>
- </note>
-
- <para>The first page of the wizard asks for the selection of the source
Guvnor repository
- and gives the choice to create a new Guvnor repository connection (in which
case the
- second page is the same as the <link
linkend="guvnor_connection_wizard">Guvnor Connection
wizard</link>).</para>
-
- <figure>
- <title>Resource from Guvnor Wizard</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/functionality_overview/add_toGuvnor_wizard.png"/>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>Once the source Guvnor repository is chosen, the wizard prompts for
resource selection:</para>
-
- <figure>
- <title>Resource Selection</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/functionality_overview/resource_from_guvnor.png"/>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>Finally, the target location in the local workspace should be
chosen:</para>
- <figure>
- <title>Choosing the Target Location</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/functionality_overview/resource_from_guvnor2.png"/>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>On completion the wizard copies the selected files from the Guvnor
repository to the local workspace.
- If a file with the same name already exists in the destination, the wizard
uses the Eclipse standard
- "prompt for rename" dialog:</para>
-
- <figure>
- <title>Prompt for Rename Dialog</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/functionality_overview/resource_from_guvnor3.png"/>
- </imageobject>
- </mediaobject>
- </figure>
- </section>
<section id="actions">
<title>Managing Guvnor Resources</title>
Modified: trunk/drools/docs/guvnor_ref/en-US/guvnor_preferences.xml
===================================================================
--- trunk/drools/docs/guvnor_ref/en-US/guvnor_preferences.xml 2010-05-05 13:34:07 UTC (rev
21906)
+++ trunk/drools/docs/guvnor_ref/en-US/guvnor_preferences.xml 2010-05-05 14:42:46 UTC (rev
21907)
@@ -15,8 +15,8 @@
<title>Guvnor Repository Exploring Perspective</title>
<para>The <property>Guvnor Repository Exploring
perspective</property> contains two views
- supplied by <property>EGT</property> – <property>Repository
Explorer</property> and
- <property>Version History</property>, that will be the center of
most interaction
+ supplied by <property>EGT</property> – <link
linkend="guvnor_repositories_view">Guvnor Repositories</link> and
+ <link linkend="guvnor_history_view">Guvnor Resource
History</link>, that will be the center of most interactions
with Guvnor, and Eclipse standard views such as
<property>Properties</property> and
<property>Resource Navigator</property> that are also
useful.</para>
@@ -39,6 +39,7 @@
<property>Guvnor Repository
Exploring</property>.</emphasis> This opens the
<property>Guvnor perspective</property>.</para>
</section>
+
<section id="connection_wizard">
<title>Guvnor Connection Wizard</title>
@@ -160,6 +161,75 @@
This is nuisance, but your usual credentials should apply in this
case.</para>
</note>
</section>
+
+ <section id="resources_from_guvnor">
+ <title>Import from Guvnor wizard</title>
+
+ <para>In addition to the single file drag-and-drop from the
<property>Guvnor Repositories
+ view</property>, the <property>EGT</property> also includes
a wizard for copying one
+ or more files from a Guvnor repository to the local workspace (and setting
the
+ association with the Guvnor repository). This wizard is available from the
<emphasis>
+ <property>File > Import > Guvnor > Resource
from
+ Guvnor</property>
+ </emphasis> and the <emphasis>
+ <property>File > New > Other > Guvnor >
Resource from
+ Guvnor</property>
+ </emphasis> menu items.</para>
+ <note>
+ <title>Note:</title>
+
+ <para>Note that the wizard is identical but appears in both locations
to accommodate
+ users who tend to view this functionality as being in either
category.</para>
+ </note>
+
+ <para>The first page of the wizard asks for the selection of the source
Guvnor repository
+ and gives the choice to create a new Guvnor repository connection (in which
case the
+ second page is the same as the <link
linkend="guvnor_connection_wizard">Guvnor Connection
wizard</link>).</para>
+
+ <figure>
+ <title>Resource from Guvnor Wizard</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/functionality_overview/add_toGuvnor_wizard.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>Once the source Guvnor repository is chosen, the wizard prompts for
resource selection:</para>
+
+ <figure>
+ <title>Resource Selection</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/functionality_overview/resource_from_guvnor.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>Finally, the target location in the local workspace should be
chosen:</para>
+ <figure>
+ <title>Choosing the Target Location</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/functionality_overview/resource_from_guvnor2.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>On completion the wizard copies the selected files from the Guvnor
repository to the local workspace.
+ If a file with the same name already exists in the destination, the wizard
uses the Eclipse standard
+ "prompt for rename" dialog:</para>
+
+ <figure>
+ <title>Prompt for Rename Dialog</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/functionality_overview/resource_from_guvnor3.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+
<section id="guvnor_repositories_view">
<title>Guvnor Repositories View</title>
@@ -254,6 +324,7 @@
<para></para>
</section>
+
<section id="guvnor_history_view">
<title>Guvnor Resource History View</title>
Modified: trunk/drools/docs/guvnor_ref/en-US/introduction.xml
===================================================================
--- trunk/drools/docs/guvnor_ref/en-US/introduction.xml 2010-05-05 13:34:07 UTC (rev
21906)
+++ trunk/drools/docs/guvnor_ref/en-US/introduction.xml 2010-05-05 14:42:46 UTC (rev
21907)
@@ -109,8 +109,8 @@
<section id="what_is_guvnor_tools">
<title>What is Guvnor Tools?</title>
<para>The <property>Guvnor repository</property> is not
intended as a Source Code Management
- (SCM) solution, and the <property>EGT</property> are not intended to
be Eclipse “team
- provider” extensions or replacements. Rather, the Guvnor repository is a location
where
+ (SCM) solution, and the <property>EGT</property> is not intended to
be Eclipse “team
+ provider” extension or replacement. Rather, the Guvnor repository is a location
where
certain artifacts (such as rules and SOA policy definitions) are controlled
(“governed”) by
policies defined by the deployment environment. The purpose of the
<property>EGT</property>
is then to enable access to resources held by the Guvnor repository, so
@@ -160,8 +160,8 @@
java.lang.RuntimeException: Specification violation [EJB3 JPA 6.2.1.2] - You have not
defined a non-jta-data-source
for a RESOURCE_LOCAL enabled persistence context named: ACL
</programlisting>
- <para>Now refer to the <link
linkend="functionality_overview">"Functionality
- Overview"</link> section to find out what you can do with
Guvnor and
+ <para>Now refer to the <link
linkend="functionality_overview">"Tasks"</link>
+ section to find out what you can do with Guvnor and
Eclipse synchronisation tool.</para>
</section>