Author: irooskov(a)redhat.com Date: 2010-01-24 23:16:07 -0500 (Sun, 24 Jan 2010) New Revision: 19896 Modified: trunk/documentation/guides/Beginners_Guide/en-US/Book_Info.xml trunk/documentation/guides/Beginners_Guide/en-US/Feedback.xml trunk/documentation/guides/Beginners_Guide/en-US/Introduction.xml trunk/documentation/guides/Beginners_Guide/en-US/Java_Web_(EE)_and_Standard_Edition_(SE).xml trunk/documentation/guides/Beginners_Guide/en-US/Revision_History.xml trunk/documentation/guides/Beginners_Guide/en-US/Service-Oriented_Architecture_Development.xml trunk/documentation/guides/Beginners_Guide/en-US/The_interface.xml trunk/documentation/guides/Beginners_Guide/en-US/Where_to_go_from_here.xml Log: updated book with info from Max's tech review Modified: trunk/documentation/guides/Beginners_Guide/en-US/Book_Info.xml =================================================================== --- trunk/documentation/guides/Beginners_Guide/en-US/Book_Info.xml 2010-01-23 16:01:32 UTC (rev 19895) +++ trunk/documentation/guides/Beginners_Guide/en-US/Book_Info.xml 2010-01-25 04:16:07 UTC (rev 19896) @@ -3,14 +3,14 @@ ]> <bookinfo id="book-Beginners_Guide-Beginners_Guide"> <title>Beginners Guide</title> - <subtitle>Provides information about the use of <application>JBoss Tools </application>and the <application>JBoss Developer Studio</application> from a beginners level.</subtitle> + <subtitle>Provides information about the use of the <application>JBoss Developer Studio</application> from a beginners level.</subtitle> <productname>JBoss Developer Studio</productname> <productnumber>3.0</productnumber> <edition>1.0</edition> <pubsnumber>7</pubsnumber> <abstract> <para> -The Beginners Guide brings all concepts pertaining to <application>JBoss Tools</application>&nbsp; and the <application>JBoss Developer Studio</application>&nbsp; back to basics. It is intended for individuals who may be +The Beginners Guide brings all concepts pertaining to the <application>JBoss Developer Studio</application>&nbsp; back to basics. It is intended for individuals who may be new to application servers and the creation of applications for deployment. </para> Modified: trunk/documentation/guides/Beginners_Guide/en-US/Feedback.xml =================================================================== --- trunk/documentation/guides/Beginners_Guide/en-US/Feedback.xml 2010-01-23 16:01:32 UTC (rev 19895) +++ trunk/documentation/guides/Beginners_Guide/en-US/Feedback.xml 2010-01-25 04:16:07 UTC (rev 19896) @@ -7,7 +7,7 @@ <secondary>contact information for this manual</secondary> </indexterm> <para> - If you find a typographical error in this manual, or if you have thought of a way to make this manual better, we would love to hear from you! Please submit a report in JIRA agaist JBoss Tools for the community: <ulink url="https://jira.jboss.org/jira/browse/JBIDE">https://jira.... or JBoss Developer Studio for the enterprise: <ulink url="https://jira.jboss.org/jira/browse/JBDS">https://jira.j... + If you find a typographical error in this manual, or if you have thought of a way to make this manual better, we would love to hear from you! Please submit a report in JIRA against JBoss Developer Studio: <ulink url="https://jira.jboss.org/jira/browse/JBDS">https://jira.j... </para> <para> When submitting a bug report, be sure to mention the manual's name. Modified: trunk/documentation/guides/Beginners_Guide/en-US/Introduction.xml =================================================================== --- trunk/documentation/guides/Beginners_Guide/en-US/Introduction.xml 2010-01-23 16:01:32 UTC (rev 19895) +++ trunk/documentation/guides/Beginners_Guide/en-US/Introduction.xml 2010-01-25 04:16:07 UTC (rev 19896) @@ -3,10 +3,10 @@ <chapter id="chap-Beginners_Guide-Introduction"> <title>Introduction</title> <para> - The <application>JBoss Tools</application> and <application>JBoss Developer Studio</application> tools suites are designed to assist with the development of applications and services for JBoss Middleware software. These tools have been developed and are used by developers to increase their efficiency and productivity with JBoss software offerings (be it community or enterprise offerings). + The <application>JBoss Developer Studio</application> is an Integrated Development Environment (IDE) that includes JBoss Tools and assists with the development of applications and services on JBoss Middleware software. These tools have been developed and are used by developers for increased efficiency and productivity with JBoss software. </para> <para> - This beginners guide covers the basics of the interface you will be working with and the tools within it, assuming as little knowledge on your side as possible. If you are not familiar with <application>JBoss Tools</application> or <application>JBoss Developer Studio</application> then this guide provides the best place to begin. + This guide covers the basics of the interface you will be working with and the tools within it, assuming as little knowledge on your side as possible. If you are not familiar with <application>JBoss Developer Studio</application> then this guide is the best place to begin. </para> </chapter> Modified: trunk/documentation/guides/Beginners_Guide/en-US/Java_Web_(EE)_and_Standard_Edition_(SE).xml =================================================================== --- trunk/documentation/guides/Beginners_Guide/en-US/Java_Web_(EE)_and_Standard_Edition_(SE).xml 2010-01-23 16:01:32 UTC (rev 19895) +++ trunk/documentation/guides/Beginners_Guide/en-US/Java_Web_(EE)_and_Standard_Edition_(SE).xml 2010-01-25 04:16:07 UTC (rev 19896) @@ -3,12 +3,12 @@ <chapter id="chap-Beginners_Guide-Java_Web_EE_and_Standard_Edition_SE_Plug_Ins"> <title>Java Web (EE) and Standard Edition (SE) Plug-Ins</title> <para> - This chapter covers the Java plug-ins included with <application>JBoss Tools</application> and the <application>JBoss Developer Studio</application>. + Included <application>JBoss Developer Studio</application> Java plug-ins are detailed. </para> <section id="sect-Beginners_Guide-Java_Web_EE_and_Standard_Edition_SE_Plug_Ins-Visual_Web_Tools"> <title>Visual Web Tools</title> <para> - The Visual Web Tools consist of a number of features designed to aid in the development of web pages and web projects. + Visual Web Tools aids in the development of web pages and web projects. </para> <variablelist> <varlistentry> @@ -21,7 +21,7 @@ <title>Visual Page Editor</title> <mediaobject> <imageobject> - <imagedata fileref="images/figu-Beginners_Guide-Visual_Web_Tools-Visual_Page_Editor.png" format="PNG" width="444" /> + <imagedata fileref="images/figu-Beginners_Guide-Visual_Web_Tools-Visual_Page_Editor.png" format="PNG" /> </imageobject> <textobject> <phrase> @@ -108,7 +108,7 @@ <term>Web Projects View</term> <listitem> <para> - The Web Projects View is an additional view for <application>JBoss Tools</application> and the <application>JBoss Developer Studio</application>. It enhances project authoring with a number of features: + The Web Projects View is an additional view. It enhances project authoring with a number of features: </para> <itemizedlist> <listitem> @@ -118,7 +118,7 @@ </listitem> <listitem> <para> - Selected items can be dragged and dropped into <acronym>JSP</acronym> pages: + Selected items can be dragged and dropped into <acronym>JSP</acronym> and other <acronym>JSF</acronym> compatible pages: </para> <itemizedlist> <listitem> @@ -153,11 +153,11 @@ </listitem> </itemizedlist> </listitem> - <listitem> + <!-- <listitem> <para> Context menus can be used to speed up application authoring. </para> - </listitem> + </listitem> --> <listitem> <para> <acronym>JSF</acronym> and Struts projects can be quickly created or imported from the shortcut buttons. @@ -173,7 +173,7 @@ <title>Web Projects View for <acronym>JSF</acronym> (left) and Struts (right) projects</title> <mediaobject> <imageobject> - <imagedata fileref="images/figu-Beginners_Guide-Visual_Web_Tools-Web_Projects_View_for_JSF_left_and_Struts_right_projects.png" format="PNG" width="444" /> + <imagedata fileref="images/figu-Beginners_Guide-Visual_Web_Tools-Web_Projects_View_for_JSF_left_and_Struts_right_projects.png" format="PNG" /> </imageobject> <textobject> <phrase> @@ -191,7 +191,7 @@ <term>OpenOn</term> <listitem> <para> - OpenOn provides an easy method to switch directly from one resource to another in the project without navigating through the <guilabel>Package Explorer</guilabel> view. Pressing <keycap>F3</keycap> or <keycombo><keycap>Ctrl</keycap><mousebutton>click</mousebutton></keycombo> when a reference to another file is highlighted will open the file in the editor. + OpenOn provides an easy method for switching directly from one project resource to another without navigating through the <guilabel>Package Explorer</guilabel> view. Pressing <keycap>F3</keycap> or <keycombo><keycap>Ctrl</keycap><mousebutton>click</mousebutton></keycombo> when a reference to another file is highlighted will open the file in the editor. </para> <para> Refer to the <citetitle pubwork="chapter">Editors</citetitle> chapter of <citetitle pubwork="book">Visual Web Tools Reference Guide</citetitle> for full details. @@ -211,7 +211,7 @@ <title>Content Assist</title> <mediaobject> <imageobject> - <imagedata fileref="images/figu-Beginners_Guide-Visual_Web_Tools-Content_Assist.png" format="PNG" width="444" /> + <imagedata fileref="images/figu-Beginners_Guide-Visual_Web_Tools-Content_Assist.png" format="PNG" /> </imageobject> <textobject> <phrase> @@ -240,7 +240,7 @@ <term>RichFaces Support</term> <listitem> <para> - The RichFaces framework is tightly integrated with <application>JBoss Tools</application> and the <application>JBoss Developer Studio</application>. RichFaces and Ajax4jsf tag libraries can be used in the JBoss Tools Palette, and RichFaces components are rendered in the Visual Page Editor. + RichFaces and Ajax4jsf tag libraries can be used from the JBoss Tools Palette, and RichFaces components are rendered in the Visual Page Editor. </para> <para> Refer to the <citetitle pubwork="chapter">Editors</citetitle> chapter of <citetitle pubwork="book">Visual Web Tools Reference Guide</citetitle> for full details. @@ -253,7 +253,7 @@ <section id="sect-Beginners_Guide-Java_Web_EE_and_Standard_Edition_SE_Plug_Ins-Seam_Development_Tools"> <title>Seam Development Tools</title> <para> - <application>JBoss Seam</application> is an application framework that simplifies the development of Web 2.0 applications. It combines several technologies to reduce the complexity of developing modern web applications: + <application>JBoss Seam</application> combines several technologies to reduce the complexity of developing modern Web 2.0 applications: </para> <itemizedlist> <listitem> @@ -286,7 +286,7 @@ <application>Seam</application> provides an interface to these different technologies through simple <emphasis>Plain Old Java Objects</emphasis> (<acronym>POJO</acronym>), user interface components, and <acronym>XML</acronym>. <application>Seam</application> does not distinguish between presentation-tier components and business logic components in an effort to present a simple, unified component model for the Java Enterprise Edition platform. Seam also provides mechanisms to manage application states across multiple workspaces, methods to manage workflow and pageflow through <acronym>jBPM</acronym>, and comprehensive integrated testing features. </para> <para> - The Seam Development Tools in <application>JBoss Tools</application> and the <application>JBoss Developer Studio</application> allow for easy <application>Seam</application> application development: + The Seam Development Tools in the <application>JBoss Developer Studio</application> allow for easy <application>Seam</application> application development: </para> <variablelist> <varlistentry> @@ -330,7 +330,7 @@ <term>Editors and views</term> <listitem> <para> - There are a number of editors available in <application>JBoss Tools</application> and the <application>JBoss Developer Studio</application> for working with Seam in addition to the Visual Page Editor: + There are a number of editors available in the <application>JBoss Developer Studio</application> for working with Seam in addition to the Visual Page Editor: </para> <variablelist> <varlistentry> @@ -360,7 +360,7 @@ <title>Seam Pages Editor (graphical view)</title> <mediaobject> <imageobject> - <imagedata fileref="images/figu-Beginners_Guide-Seam_Development_Tools-Seam_Pages_Editor_graphical_view.png" format="PNG" width="444" /> + <imagedata fileref="images/figu-Beginners_Guide-Seam_Development_Tools-Seam_Pages_Editor_graphical_view.png" format="PNG" /> </imageobject> <textobject> <phrase> @@ -381,7 +381,7 @@ <title>Seam Components Editor</title> <mediaobject> <imageobject> - <imagedata fileref="images/figu-Beginners_Guide-Seam_Development_Tools-Seam_Components_Editor.png" format="PNG" width="444" /> + <imagedata fileref="images/figu-Beginners_Guide-Seam_Development_Tools-Seam_Components_Editor.png" format="PNG" /> </imageobject> <textobject> <phrase> @@ -426,10 +426,10 @@ <section id="sect-Beginners_Guide-Java_Web_EE_and_Standard_Edition_SE_Plug_Ins-Hibernate_Tools"> <title>Hibernate Tools</title> <para> - <application>Hibernate</application> is an object-relational mapping (<acronym>ORM</acronym>) library, used for mapping an object-oriented domain model to a relational database. It replaces persistence-related database accesses with high-level object-handling functions to solve problems relating to object-relational impedance mismatch. <application>Hibernate</application> also serves as a query service, allowing queries to be expressed in native <acronym>SQL</acronym> (Structured Query Language), an extension of <acronym>SQL</acronym> named <emphasis>Hibernate Query Language</emphasis> (<acronym>HQL</acronym>), or an object-oriented Criteria and Example <acronym>API</acronym> (Application Programming Interface). + <application>Hibernate</application> is an object-relational mapping (<acronym>ORM</acronym>) library, used for mapping an object-oriented domain model to a relational database.<!-- It replaces persistence-related database accesses with high-level object-handling functions to solve problems relating to object-relational impedance mismatch.--> <application>Hibernate</application> also serves as a query service, allowing queries to be expressed in native <acronym>SQL</acronym> (Structured Query Language), an extension of <acronym>SQL</acronym> named <emphasis>Hibernate Query Language</emphasis> (<acronym>HQL</acronym>), or an object-oriented Criteria and Example <acronym>API</acronym> (Application Programming Interface). </para> <para> - Hibernate Tools in <application>JBoss Tools</application> and the <application>JBoss Developer Studio</application> provides several features to aid in developing with <application>Hibernate</application>: + Hibernate Tools in the <application>JBoss Developer Studio</application> provides several features to aid in developing with <application>Hibernate</application>: </para> <variablelist> <varlistentry> @@ -450,7 +450,7 @@ <title>Hibernate Console</title> <mediaobject> <imageobject> - <imagedata fileref="images/figu-Beginners_Guide-Hibernate_Tools-Hibernate_Console.png" format="PNG" width="444" /> + <imagedata fileref="images/figu-Beginners_Guide-Hibernate_Tools-Hibernate_Console.png" format="PNG" /> </imageobject> <textobject> <phrase> @@ -494,7 +494,7 @@ <section id="sect-Beginners_Guide-Java_Web_EE_and_Standard_Edition_SE_Plug_Ins-Portal_Tools"> <title>Portal Tools</title> <para> - <application>JBoss Portal</application> is a platform for hosting and serving the web interface of a portal. It allows for content management and experience customization, and supports standard portlets, single sign-ons, clustering, and internationalization. + <application>JBoss Portal</application> is a platform for hosting and serving the web interface of a web portal. It allows for content management and experience customization, and supports standard portlets, single sign-ons, clustering, and internationalization. </para> <para> <application>JBoss Portal</application> applications can be created through the Dynamic Web Project wizard. Java portlets, <acronym>JSF</acronym> portlets, and Seam portlets are all supported. @@ -503,7 +503,7 @@ <title>Dynamic Web Project wizard</title> <mediaobject> <imageobject> - <imagedata fileref="images/figu-Beginners_Guide-Portal_Tools-Dynamic_Web_Project_wizard.png" format="PNG" width="444" /> + <imagedata fileref="images/figu-Beginners_Guide-Portal_Tools-Dynamic_Web_Project_wizard.png" format="PNG" /> </imageobject> <textobject> <phrase> @@ -513,6 +513,9 @@ </mediaobject> </figure> <para> + Click the <guibutton>Modify...</guibutton> button and enable portlets for the creation of <application>JBoss Portal</application> applications through this wizard. + </para> + <para> Refer to the <citetitle pubwork="book">JBoss Portal Tools Reference Guide</citetitle> for full details. </para> </section> @@ -523,7 +526,7 @@ Java Management Extensions (<acronym>JMX</acronym>) is a Java tool-set for managing and monitoring applications, connected devices, and service-oriented networks. A managed resource is represented by a dynamic object called a <emphasis>Managed Bean</emphasis> (or <emphasis>MBean</emphasis>, which is a JavaBean with a dependency injection. </para> <para> - The <acronym>JMX</acronym> Tools in <application>JBoss Tools</application> and the <application>JBoss Developer Studio</application> consist on the <emphasis>MBean Explorer</emphasis> and the <emphasis>MBean Editor</emphasis>. + The <acronym>JMX</acronym> Tools consists of the <emphasis>MBean Explorer</emphasis> and the <emphasis>MBean Editor</emphasis>. </para> <variablelist> <varlistentry> @@ -579,7 +582,7 @@ <title>MBean Editor</title> <mediaobject> <imageobject> - <imagedata fileref="images/figu-Beginners_Guide-JMX_Tools-MBean_Editor.png" format="PNG" width="444" /> + <imagedata fileref="images/figu-Beginners_Guide-JMX_Tools-MBean_Editor.png" format="PNG" /> </imageobject> <textobject> <phrase> @@ -596,16 +599,85 @@ </para> </section> + <section id="sect-Beginners_Guide-Java_Web_EE_and_Standard_Edition_SE_Plug_Ins-JSF_Tools"> + <title>JSF Tools</title> + <para> + JavaServer Faces (JSF) is a Web application framework developed by Sun Microsystems© Inc. JSF Tools allows you to build JSF based applications, add JSF capabilities to existing web projects, import JSF projects and choose a JSF implementation during application development. + </para> + <para> + The tools included are outlined as follows: + </para> + <itemizedlist> + <listitem> + <para> + Wizards that assist with the creation of new JSF and Facelets projects and adding JSF capabilities to existing web projects. + </para> + </listitem> + <listitem> + <para> + Pre-configured templates are included and the functionality to create your own. + </para> + </listitem> + <listitem> + <para> + Add and generate code for new managed beans and then add them to a JSF configuration file. + </para> + </listitem> + <listitem> + <para> + The ability to create your own custom Converter and Validator. + </para> + </listitem> + <listitem> + <para> + Constant validation checking no matter how you are currently interacting with the code, ensures you are always aware of any errors during the development process. + </para> + </listitem> + <listitem> + <para> + Three views are provided for interacting with the code: Diagram view, Tree view and Source view. Synchronization between the views ensures you are always working on the newest version. + </para> + <figure id="figu-Beginners_Guide-JSF_Tools-Diagram_view"> + <title>Diagram view</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/JSF_diagram_view.png" format="PNG" /> + </imageobject> + </mediaobject> + </figure> + <figure id="figu-Beginners_Guide-JSF_Tools-Tree_view"> + <title>Tree view</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/JSF_tree_view.png" format="PNG" /> + </imageobject> + </mediaobject> + </figure> + <figure id="figu-Beginners_Guide-JSF_Tools-Source_view"> + <title>Source view</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/JSF_source_view.png" format="PNG" /> + </imageobject> + </mediaobject> + </figure> + </listitem> + </itemizedlist> + <para> + Refer to the <citetitle pubwork="book">JSF Tools Reference Guide</citetitle> for more details. + </para> + </section> + <section id="sect-Beginners_Guide-Java_Web_EE_and_Standard_Edition_SE_Plug_Ins-JBoss_AS_Tools"> <title>JBoss AS Tools</title> <para> - The JBoss <acronym>AS</acronym> Tools consist of a number of additional views for managing an installed JBoss Server through the JBoss <acronym>AS</acronym> (Application Server) perspective. These additional views include the standard Console view and Properties view, and the Servers view. The Servers view allows installed servers to be configured, monitored, and managed. + The JBoss <acronym>AS</acronym> Tools consists of a number of additional views for managing an installed JBoss Server through the JBoss <acronym>AS</acronym> (Application Server) perspective. These additional views include the standard Console and Properties views, and the Servers view. The Servers view allows installed servers to be configured, monitored, and managed. </para> <figure id="figu-Beginners_Guide-JBoss_AS_Tools-Servers_view"> <title>Servers view</title> <mediaobject> <imageobject> - <imagedata fileref="images/figu-Beginners_Guide-JBoss_AS_Tools-JBoss_Server_View.png" format="PNG" width="444" /> + <imagedata fileref="images/figu-Beginners_Guide-JBoss_AS_Tools-JBoss_Server_View.png" format="PNG" /> </imageobject> <textobject> <phrase> @@ -628,7 +700,7 @@ <title>Archive Tools</title> <mediaobject> <imageobject> - <imagedata fileref="images/figu-Beginners_Guide-Archive_Tools-Archive_Tools.png" format="PNG" width="444" /> + <imagedata fileref="images/figu-Beginners_Guide-Archive_Tools-Archive_Tools.png" format="PNG" /> </imageobject> <textobject> <phrase> Modified: trunk/documentation/guides/Beginners_Guide/en-US/Revision_History.xml =================================================================== --- trunk/documentation/guides/Beginners_Guide/en-US/Revision_History.xml 2010-01-23 16:01:32 UTC (rev 19895) +++ trunk/documentation/guides/Beginners_Guide/en-US/Revision_History.xml 2010-01-25 04:16:07 UTC (rev 19896) @@ -18,6 +18,20 @@ </simplelist> </revdescription> </revision> + <revision> + <revnumber>1</revnumber> + <date>Mon Jan 26 2010</date> + <author> + <firstname>Isaac</firstname> + <surname>Rooskov</surname> + <email&gt;irooskov(a)redhat.com&lt;/email&gt; + </author> + <revdescription> + <simplelist> + <member>Review and editing</member> + </simplelist> + </revdescription> + </revision> </revhistory> </simpara> </appendix> Modified: trunk/documentation/guides/Beginners_Guide/en-US/Service-Oriented_Architecture_Development.xml =================================================================== --- trunk/documentation/guides/Beginners_Guide/en-US/Service-Oriented_Architecture_Development.xml 2010-01-23 16:01:32 UTC (rev 19895) +++ trunk/documentation/guides/Beginners_Guide/en-US/Service-Oriented_Architecture_Development.xml 2010-01-25 04:16:07 UTC (rev 19896) @@ -3,12 +3,12 @@ <chapter id="chap-Beginners_Guide-Service_Oriented_Architecture_Development"> <title>Service-Oriented Architecture Development</title> <para> - This chapter covers the <application>JBoss Tools</application> and the <application>JBoss Developer Studio</application> plug-ins for development on Service-Oriented Architecture (SOA). + Included <application>JBoss Developer Studio</application> plug-ins for development on Service-Oriented Architecture (SOA) are detailed. </para> <section id="sect-Beginners_Guide-Service_Oriented_Architecture_Development-jBPM_Tools"> <title>jBPM Tools</title> <para> - jBPM is a workflow tool, allowing for the creation of framework control over business processes and languages. + jBPM is a workflow tool for framework control over business processes and languages. </para> <para> jBPM supports the jBPM Process Definition Language (jPDL) and includes a perspective for easy creation and manipulation using the jPDL. Through this view you can add states, transitions and other processes and waypoints in order to create your own business workflow. Refer to the <citetitle pubwork="section">A Minimal Process Definition</citetitle> section of the <citetitle pubwork="chapter">Creating an Empty Process Definition</citetitle> chapter within the <citetitle pubwork="book">jBPM Tools Reference Guide</citetitle> for more details. @@ -27,12 +27,12 @@ <title>ESB Editor</title> <mediaobject> <imageobject> - <imagedata fileref="images/ESB_Editor.png" format="PNG" width="444" /> + <imagedata fileref="images/ESB_Editor.png" format="PNG" /> </imageobject> </mediaobject> </figure> <para> - <application>JBoss Tools</application> and the <application>JBoss Developer Studio</application> include a tool called the ESB file Editor. Through the use of this tool you can develop an application that will utilize the advantages of ESB technology. Features of the ESB Editor include: + The <application>JBoss Developer Studio</application> includes a tool called the ESB file Editor. Through the use of this tool you can develop an application that will utilize the advantages of ESB technology. Features of the ESB Editor include: </para> <formalpara id="form-Beginners_Guide-ESB_Editor-ESB_syntax_validation"> <title>ESB syntax validation</title> @@ -72,24 +72,24 @@ JBoss Web Services is an integral part of the JBoss Application Server and JBoss Enterprise Application Platform, providing a standard means of working reliably between different software applications. </para> <para> - A Web Service defines a collection of technologies that provide protocols and standards for the exchange of data between applications. You can create a Web Service for your application server through the use of wizards in <application>JBoss Tools</application> or the <application>JBoss Developer Studio</application>. For further details refer to the <citetitle pubwork="chapter">Creating a Web Service using JBossWS runtime</citetitle> chapter of the <citetitle pubwork="book">JBoss WS User Guide</citetitle> + A Web Service defines a collection of technologies that provide protocols and standards for the exchange of data between applications. You can create a Web Service for your application server through the use of wizards in the <application>JBoss Developer Studio</application>. For further details refer to the <citetitle pubwork="chapter">Creating a Web Service using JBossWS runtime</citetitle> chapter of the <citetitle pubwork="book">JBoss WS User Guide</citetitle> </para> <figure id="figu-Beginners_Guide-Web_Services_Tools-Example_of_a_Web_Services_wizard"> <title>Example of a Web Services wizard</title> <mediaobject> <imageobject> - <imagedata fileref="images/Web_Services_Wizard.png" format="PNG" width="444" /> + <imagedata fileref="images/Web_Services_Wizard.png" format="PNG" /> </imageobject> </mediaobject> </figure> <para> - Web Services Tools also includes the ability to create a Web Service client through the use of a Web Services Description Language (WSDL) document. This can be useful if you already have a predefined service that you wish to recreate in JBoss Tools, or you wish to use one as a template for you to work with. Refer to the <citetitle pubwork="chapter">Creating a Web Service Client from a WSDL Document using JBoss WS</citetitle> chapter of the <citetitle pubwork="book">JBoss WS User Guide</citetitle> for more details. + Web Services Tools also includes the ability to create a Web Service client through the use of a Web Services Description Language (WSDL) document. This can be useful if you already have a predefined service that you wish to recreate, or you wish to use one as a template for you to work with. Refer to the <citetitle pubwork="chapter">Creating a Web Service Client from a WSDL Document using JBoss WS</citetitle> chapter of the <citetitle pubwork="book">JBoss WS User Guide</citetitle> for more details. </para> <figure id="figu-Beginners_Guide-Web_Services_Tools-Web_Services_client_creation"> <title>Web Services client creation</title> <mediaobject> <imageobject> - <imagedata fileref="images/Web_Services_Using_Document.png" format="PNG" width="444" /> + <imagedata fileref="images/Web_Services_Using_Document.png" format="PNG" /> </imageobject> </mediaobject> </figure> @@ -107,7 +107,7 @@ <title>Rule text editor</title> <mediaobject> <imageobject> - <imagedata fileref="images/Drools_code_rule_editor.png" format="PNG" width="444" /> + <imagedata fileref="images/Drools_code_rule_editor.png" format="PNG" /> </imageobject> </mediaobject> </figure> @@ -115,7 +115,7 @@ <title>Rule Flow graphical editor</title> <mediaobject> <imageobject> - <imagedata fileref="images/Drools_rete_rule_editor.png" format="PNG" width="444" /> + <imagedata fileref="images/Drools_rete_rule_editor.png" format="PNG" /> </imageobject> </mediaobject> </figure> @@ -139,7 +139,7 @@ <title>Guvnor connection wizard</title> <mediaobject> <imageobject> - <imagedata fileref="images/Guvnor_connection_wizard.png" format="PNG" width="444" /> + <imagedata fileref="images/Guvnor_connection_wizard.png" format="PNG" /> </imageobject> </mediaobject> </figure> @@ -153,7 +153,7 @@ <title>Guvnor repository view</title> <mediaobject> <imageobject> - <imagedata fileref="images/Guvnor_repository.png" format="PNG" width="444" /> + <imagedata fileref="images/Guvnor_repository.png" format="PNG" /> </imageobject> </mediaobject> </figure> @@ -167,7 +167,7 @@ <title>Guvnor resource history view</title> <mediaobject> <imageobject> - <imagedata fileref="images/Guvnor_resource_history_view.png" format="PNG" width="444" /> + <imagedata fileref="images/Guvnor_resource_history_view.png" format="PNG" /> </imageobject> </mediaobject> </figure> @@ -181,7 +181,7 @@ <title>Guvnor resource importing wizard</title> <mediaobject> <imageobject> - <imagedata fileref="images/Guvnor_copy_file.png" format="PNG" width="444" /> + <imagedata fileref="images/Guvnor_copy_file.png" format="PNG" /> </imageobject> </mediaobject> </figure> @@ -238,74 +238,7 @@ </para> </section> - <section id="sect-Beginners_Guide-Service_Oriented_Architecture_Development-JSF_Tools"> - <title>JSF Tools</title> - <para> - JavaServer Faces (JSF) is a Web application framework developed by Sun Microsystems© Inc. that <application>JBoss Tools</application> and the <application>JBoss Developer Studio</application> provide developer tools for. JSF Tools allows you to build JSF based applications, add JSF capabilities to existing web projects, import JSF projects and choose a JSF implementation during application development. - </para> - <para> - The tools included are outlined as follows: - </para> - <itemizedlist> - <listitem> - <para> - Wizards that assist with the creation of new JSF and Facelets projects and adding JSF capabilities to existing web projects. - </para> - </listitem> - <listitem> - <para> - Pre-configured templates are included and the functionality to create your own. - </para> - </listitem> - <listitem> - <para> - Add and generate code for new managed beans and then add them to a JSF configuration file. - </para> - </listitem> - <listitem> - <para> - The ability to create your own custom Converter and Validator. - </para> - </listitem> - <listitem> - <para> - Constant validation checking no matter how you are currently interacting with the code, ensures you are always aware of any errors during the development process. - </para> - </listitem> - <listitem> - <para> - Three views are provided for interacting with the code: Diagram view, Tree view and Source view. Synchronization between the views ensures you are always working on the newest version. - </para> - <figure id="figu-Beginners_Guide-JSF_Tools-Diagram_view"> - <title>Diagram view</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/JSF_diagram_view.png" format="PNG" width="444" /> - </imageobject> - </mediaobject> - </figure> - <figure id="figu-Beginners_Guide-JSF_Tools-Tree_view"> - <title>Tree view</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/JSF_tree_view.png" format="PNG" width="444" /> - </imageobject> - </mediaobject> - </figure> - <figure id="figu-Beginners_Guide-JSF_Tools-Source_view"> - <title>Source view</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/JSF_source_view.png" format="PNG" width="444" /> - </imageobject> - </mediaobject> - </figure> - </listitem> - </itemizedlist> - <para> - Refer to the <citetitle pubwork="book">JSF Tools Reference Guide</citetitle> for more details. - </para> - </section> + </chapter> Modified: trunk/documentation/guides/Beginners_Guide/en-US/The_interface.xml =================================================================== --- trunk/documentation/guides/Beginners_Guide/en-US/The_interface.xml 2010-01-23 16:01:32 UTC (rev 19895) +++ trunk/documentation/guides/Beginners_Guide/en-US/The_interface.xml 2010-01-25 04:16:07 UTC (rev 19896) @@ -3,24 +3,24 @@ <chapter id="chap-Beginners_Guide-The_interface"> <title>The interface</title> <para> - This chapter discusses the interfaces that the <application>JBoss Tools</application> and the <application>JBoss Developer Studio</application> plug-ins are built for. + The interfaces that the <application>JBoss Developer Studio</application> IDE is built for are discussed. </para> <section id="sect-Beginners_Guide-The_interface-Eclipse"> <title>Eclipse</title> <para> - Eclipse is the container for all development work in <application>JBoss Tools</application> and the <application>JBoss Developer Studio</application>. It allows for control over the running of the application server, the applications on it and provides an interface for developing your own applications. + Eclipse is the container for all development work in the <application>JBoss Developer Studio</application>. It allows for control over the running of the application server, the applications on it and provides an interface for developing your own applications. </para> <para> Eclipse is started by double-clicking on the <filename>eclipse</filename> executeable in your installation directory. </para> <para> - Following this you will be asked to specify a workspace for your Eclipse session. A workspace is the location on your computer where your files will be stored relating to the session. If you wish to change your workspace location after this step you can do so by following the menu items <guimenuitem>File</guimenuitem>, <guimenuitem>Switch Workspace</guimenuitem>, <guimenuitem>Other...</guimenuitem>. + Following this you will be asked to specify a workspace. A workspace is the location on your computer where your files will be stored relating to the multiple sessions. If you wish to change your workspace location after this step you can do so by following the menu items <guimenuitem>File</guimenuitem>, <guimenuitem>Switch Workspace</guimenuitem>, <guimenuitem>Other...</guimenuitem>. </para> <figure id="figu-Beginners_Guide-Eclipse-Eclipse_Workspace_launcher"> <title>Eclipse Workspace launcher</title> <mediaobject> <imageobject> - <imagedata fileref="images/Eclipse_workspace.png" format="PNG" width="444" /> + <imagedata fileref="images/Eclipse_workspace.png" format="PNG" /> </imageobject> </mediaobject> </figure> @@ -31,7 +31,7 @@ <title>Eclipse welcome screen</title> <mediaobject> <imageobject> - <imagedata fileref="images/Eclipse_welcome_screen.png" format="PNG" width="444" /> + <imagedata fileref="images/Eclipse_welcome_screen.png" format="PNG" /> </imageobject> </mediaobject> </figure> @@ -42,7 +42,7 @@ <title>Eclipse Workbench</title> <mediaobject> <imageobject> - <imagedata fileref="images/Eclipse_main.png" format="PNG" width="444" /> + <imagedata fileref="images/Eclipse_main.png" format="PNG" /> </imageobject> </mediaobject> </figure> @@ -53,12 +53,12 @@ <title>Views button</title> <mediaobject> <imageobject> - <imagedata fileref="images/View_Button.png" format="PNG" width="444" /> + <imagedata fileref="images/View_Button.png" format="PNG" /> </imageobject> </mediaobject> </figure> <para> - The window that may be of most use to you can be found by following: <menuchoice><guimenuitem>Other...</guimenuitem><guimenuitem>JBoss Tools Web</guimenuitem><guimenuitem>JBoss Tools Palette</guimenuitem></menuchoice>. This window opens an interface to the tools included with <application>JBoss Tools</application> and the <application>JBoss Developer Studio</application>. + The window that may be of most use to you can be found by following: <menuchoice><guimenuitem>Other...</guimenuitem><guimenuitem>JBoss Tools Web</guimenuitem><guimenuitem>JBoss Tools Palette</guimenuitem></menuchoice>. This window opens an interface to the tools included with the <application>JBoss Developer Studio</application>. </para> <para> Refer to the <citetitle pubwork="section">Welcome to JBoss Developer Studio</citetitle> section of the <citetitle pubwork="book">Getting Started with JBoss Developer Studio</citetitle> guide for further details. @@ -70,16 +70,16 @@ <para> The JBoss Application Server provides the full range of Java EE 5 features as well as extended enterprise services including clustering, caching, and persistence. </para> - <section id="sect-Beginners_Guide-JBoss_Application_Server-Use_of_the_application_server_shipped_with_JBoss_Tools_or_JBoss_Developer_Studio"> - <title>Use of the application server shipped with JBoss Tools or JBoss Developer Studio</title> + <section id="sect-Beginners_Guide-JBoss_Application_Server-Use_of_the_application_server_shipped_with_the_JBoss_Developer_Studio"> + <title>Use of the application server shipped with the JBoss Developer Studio</title> <para> - This section discusses the JBoss Application Server with regards to its use through Eclipse. Once you have started the Eclipse interface for <application>JBoss Tools</application> or the <application>JBoss Developer Studio</application>, the JBoss Application Server can be started by clicking on its name in the lower part of the window and then clicking the green arrow to the right. + This section discusses the JBoss Application Server with regards to its use through Eclipse. Once you have started the Eclipse interface for the <application>JBoss Developer Studio</application>, the JBoss Application Server can be started by clicking on its name in the lower part of the window and then clicking the green arrow to the right. </para> <figure id="figu-Beginners_Guide-Use_of_the_application_server_shipped_with_JBoss_Tools_or_JBoss_Developer_Studio-Starting_and_stopping_the_server"> <title>Starting and stopping the server</title> <mediaobject> <imageobject> - <imagedata fileref="images/Start_Stop_Server.png" format="PNG" width="444" /> + <imagedata fileref="images/Start_Stop_Server.png" format="PNG" /> </imageobject> </mediaobject> </figure> @@ -95,7 +95,7 @@ <title>Server started successfully</title> <mediaobject> <imageobject> - <imagedata fileref="images/Server_Started.png" format="PNG" width="444" /> + <imagedata fileref="images/Server_Started.png" format="PNG" /> </imageobject> </mediaobject> </figure> @@ -106,7 +106,7 @@ <title>JBoss Application Server overview</title> <mediaobject> <imageobject> - <imagedata fileref="images/JBoss_AS_Overview.png" format="PNG" width="444" /> + <imagedata fileref="images/JBoss_AS_Overview.png" format="PNG" /> </imageobject> </mediaobject> </figure> @@ -114,13 +114,13 @@ From this <guilabel>Overview</guilabel> section there are six subsections consisting of: <guilabel>General Information</guilabel>, <guilabel>Login Credentials</guilabel>, <guilabel>Publishing</guilabel>, <guilabel>Timeouts</guilabel>, <guilabel>Server Polling</guilabel> and <guilabel>Server Ports</guilabel>. </para> <para> - The <guilabel>General Information</guilabel> subsection allows you to change the <guilabel>Server name</guilabel> and <guilabel>Host name</guilabel> to your own preferences. By clicking on the <guilabel>Runtime Environment</guilabel> label a dialog box with options to change the name of the server runtime, the home directory, the Java compiler and which server configuration should be used when running the application server. The <guibutton>Open launch configuration</guibutton> button displays a dialog box for configuring the technical details of the application server instance. + The <guilabel>General Information</guilabel> subsection allows you to change the <guilabel>Server name</guilabel> and <guilabel>Host name</guilabel> to your own preferences. By clicking on the <guilabel>Runtime Environment</guilabel> label a dialog box with options to change the name of the server runtime, the home directory, the Java Runtime and which server configuration should be used when running the application server. The <guibutton>Open launch configuration</guibutton> button displays a dialog box for configuring the technical details of the application server instance. </para> <para> - Below the <guilabel>General Information</guilabel> subsection is the <guilabel>Login Credentials</guilabel> subsection. This allows you to set the <guilabel>User Name</guilabel> and <guilabel>Password</guilabel> for your server. + Below the <guilabel>General Information</guilabel> subsection is the <guilabel>Login Credentials</guilabel> subsection. Set the <guilabel>User Name</guilabel> and <guilabel>Password</guilabel> for secure access to your server. </para> <para> - The <guilabel>Publishing</guilabel> subsection at the top right of the <guilabel>Overview</guilabel> section allows you to set when applications should be made available through the application server. You can select to either never have an application be published automatically or for a check of new applications yet to be published to occur at a certain timed interval. + The <guilabel>Publishing</guilabel> subsection at the top right of the <guilabel>Overview</guilabel> section allows you to set when applications will be published to the location specified (whether the applications will be made available through the application server depends on the server running and if it is configured to recognise dynamic changes). You can select to either never have an application be published automatically or for a check of new applications yet to be published to occur at a certain timed interval. </para> <para> The <guilabel>Timeouts</guilabel> subsection below <guilabel>Publishing</guilabel> allows you to set the start and stop time (in seconds) for the server to complete all of its operations. This setting is made available in order to decrease the chance of the server freezing or hanging. @@ -143,7 +143,7 @@ <title>Server access</title> <mediaobject> <imageobject> - <imagedata fileref="images/JBoss_AS_localhost.png" format="PNG" width="444" /> + <imagedata fileref="images/JBoss_AS_localhost.png" format="PNG" /> </imageobject> </mediaobject> </figure> @@ -152,10 +152,10 @@ </para> </section> - <section id="sect-Beginners_Guide-JBoss_Application_Server-Adding_a_new_application_server_for_use_with_JBoss_Tools_or_JBoss_Developer_Studio"> - <title>Adding a new application server for use with JBoss Tools or JBoss Developer Studio</title> + <section id="sect-Beginners_Guide-JBoss_Application_Server-Adding_a_new_application_server_for_use_with_the_JBoss_Developer_Studio"> + <title>Adding a new application server for use with the JBoss Developer Studio</title> <para> - Though JBoss Tools and JBoss Developer Studio may come with a pre-configured application server, you can still add your own servers. This section details how to add additional servers for use with JBoss Tools and the JBoss Developer Studio. + Though the JBoss Developer Studio may come with a pre-configured application server, you can still add your own servers. This section details how to add additional servers for use with the JBoss Developer Studio. </para> <para> To add a new server runtime follow these steps: Modified: trunk/documentation/guides/Beginners_Guide/en-US/Where_to_go_from_here.xml =================================================================== --- trunk/documentation/guides/Beginners_Guide/en-US/Where_to_go_from_here.xml 2010-01-23 16:01:32 UTC (rev 19895) +++ trunk/documentation/guides/Beginners_Guide/en-US/Where_to_go_from_here.xml 2010-01-25 04:16:07 UTC (rev 19896) @@ -3,19 +3,13 @@ <chapter id="chap-Beginners_Guide-Where_to_go_from_here"> <title>Where to go from here</title> <para> - For information pertaining to Eclipse visit <ulink url="http://www.eclipse.org/">www.eclipse.org</ulink>;. + For documentation on the plugins available as part of the JBoss Developer Studio visit <ulink url="http://www.redhat.com/docs/en-US/JBoss_Developer_Studio/"&...;. </para> <para> - For information about the JBoss Application Server visit <ulink url="http://www.jboss.org/jbossas/">http://www.jboss.org/jbo...;. - </para> - <para> For documentation about the JBoss Enterprise Application Platform visit <ulink url="http://www.redhat.com/docs/en-US/JBoss_Enterprise_Application_P...;. </para> <para> - For documentation on the plugins available as part of JBoss Tools visit <ulink url="http://www.jboss.org/tools/docs.html">http://www.jboss....;. + For information pertaining to Eclipse visit <ulink url="http://www.eclipse.org/">www.eclipse.org</ulink>;. </para> - <para> - For documentation on the plugins available as part of the JBoss Developer Studio visit <ulink url="http://www.redhat.com/docs/en-US/JBoss_Developer_Studio/"&...;. - </para> </chapter>