cocoon-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From shan...@apache.org
Subject cvs commit: xml-cocoon2/src/documentation/xdocs/howto/xmlform-wizard howto-xmlform-wizard.xml
Date Fri, 07 Jun 2002 01:47:10 GMT
shannon     2002/06/06 18:47:10

  Modified:    src/documentation/xdocs/howto/xmlform-wizard
                        howto-xmlform-wizard.xml
  Log:
  adding author's fixes
  
  Revision  Changes    Path
  1.4       +22 -40    xml-cocoon2/src/documentation/xdocs/howto/xmlform-wizard/howto-xmlform-wizard.xml
  
  Index: howto-xmlform-wizard.xml
  ===================================================================
  RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/howto/xmlform-wizard/howto-xmlform-wizard.xml,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -r1.3 -r1.4
  --- howto-xmlform-wizard.xml	6 Jun 2002 17:00:29 -0000	1.3
  +++ howto-xmlform-wizard.xml	7 Jun 2002 01:47:10 -0000	1.4
  @@ -6,7 +6,7 @@
       <title>XMLForm Wizard&#39;s How-To</title>
   
       <authors>
  -      <person name="Heidi Brannan"
  +      <person name="Heidi-Marie Brannan"
                 email="heidi@wkwyw.net" />
       </authors>
     </header>
  @@ -47,40 +47,29 @@
       </s1>
   
       <s1 title="Overview">
  -      <fixme author="DS">Be careful calling *anything* quick and easy. Let the
  -      reader decide if it&#39;s easy. As for quick, well, it depends on your
  -      reader, doesn&#39;t it? XMLForm introduces a *lot* of stuff that your
  -      readers may not have dealt with yet. Once you&#39;ve learned how to do
  -      it, it may then become quick and easy, but be careful how you build
  -      expecations during the learning process. I adjusted the language a bit
  -      because of this. Do you agree?</fixme>
   
         <p>XMLForm is a Cocoon form extension mechanism which was inspired by
         <link href="http://jakarta.apache.org/struts/">Struts</link> and <link
  -      href="http://www.w3.org/MarkUp/Forms/">XForms</link>. Form creation and
  -      validation can be a quick and easy addition to your site, once you learn
  -      how to apply use the XMLForm wizard. This How-To will guide your through
  +      href="http://www.w3.org/MarkUp/Forms/">XForms</link>. You will learn how
  +      to automate two-way mapping between the HTML forms, XML, and JavaBeans.
  +      XML schema languages are used to validate the form input. The forms can
  +      display different options depending on the users previous input. For example
  +      if a user ticks the checkbox to say they are interest in Cooking then they
  +      will later have the option to join Cookery mailing lists. If they did not tick
  +      the Cookery box they will not see the cookery mailing lists page.
  +      </p>
  +    </s1>
  +
  +    <s1 title="Purpose">
  +      <p>
  +      Form creation and validation can be a quick and easy addition to your site, once
you learn
  +      how to apply and use the XMLForm wizard. This How-To will guide you through
         the steps needed to create a validating form which saves the data it
         collects as a JavaBean. It will also describe <link
         href="http://www.ascc.net/xml/resource/schematron/schematron.html">Schematron</link>
         validation and the XMLForm wizard components needed to accomplish this
  -      within the Cocoon framework.</p>
  -    </s1>
  -
  -    <s1 title="Purpose">
  -      <fixme author="DS">The purpose of this section, Purpose, is to describe
  -      how the reader will benefit by reading your How-To. It&#39;s not meant
  -      to describe the purpose of XML Form wizards. You may need to pull
  -      content out of overview, above, and add some of purpose&#39;s existing
  -      content to the overview.</fixme>
  -
  -      <p>You will learn how to automate two-way mapping between the HTML
  -      forms, XML, and JavaBeans. XML schema languages are used to validate the
  -      form input. The forms can display different options depending on the
  -      users previous input. For example if a user ticks the checkbox to say
  -      they are interest in Cooking then they will later have the option to
  -      join Cookery mailing lists. If they did not tick the Cookery box they
  -      will not see the cookery mailing lists page.</p>
  +      within the Cocoon framework.
  +      </p>
       </s1>
   
       <s1 title="Intended audience">
  @@ -93,6 +82,7 @@
         <fixme author="DS">Consider adding related jar info, even though they
         are included in the HEAD branch. I find it useful to begin educating
         users about what jars they may need when they explore new approahces.</fixme>
  +      <fixme author="HMB">I will add the jars when I have a definitive list form
Ivelin</fixme>
   
         <p>You will need the following:</p>
   
  @@ -100,6 +90,7 @@
           <li>A servlet engine such as Tomcat.</li>
   
           <li>JDK 1.2 or later</li>
  +
         </ul>
   
         <p>Cocoon 2.1 CVS to be installed with the command:</p>
  @@ -168,9 +159,6 @@
       </s1>
   
       <s1 title="TIPS">
  -      <fixme author="DS">Do you really want people emailing you directly for
  -      help? It doesn&#39;t sound very sustainable over the long run.</fixme>
  -
         <p>If you have a problem running the How-To example, try the following.</p>
   
         <ul>
  @@ -182,11 +170,6 @@
           AIMS</link>. Chances are somebody else has already experienced a
           similar problem!</li>
   
  -        <li>Email <link href="mailto:heidi@kutcha.org">me</link>. I will
try
  -        to help you. Again, please send the entire error message and all
  -        relevant information. Please use the title &#34;XMLForm Help&#34; in
  -        your emails.</li>
  -
           <li>Try posting a description of your problem to the <link
           href="http://xml.apache.org/cocoon/mail-lists.html">Cocoon users email
           list</link>. Remember to include the whole error message. For a prompt
  @@ -200,14 +183,13 @@
   
       <s1 title="Related resources/documents">
         <s2 title="Cocoon">
  -        <fixme author="DS">Can you add a link to the Avalon White Paper?</fixme>
  -
           <p>For all Cocoon basics see the <link
           href="http://xml.apache.org/cocoon">Cocoon Web site</link>. For
           actions, take a look at the <link
           href=" http://xml.apache.org/cocoon/userdocs/concepts/actions.html">actions
           page</link>. Actions are Avalon Components, so you may want to read
  -        Avalon&#39;s white paper for more information.</p>
  +        Avalon&#39;s <link href="http://jakarta.apache.org/avalon/developing/">white
  +        paper</link> for more information.</p>
         </s2>
   
         <s2 title="XPath">
  @@ -219,7 +201,7 @@
       <s1 title="Comments">
         <p>Needless to say this How-To was written with no intentional mistakes
         or errors. However, if you find any faults or can suggest any
  -      improvements, please email me, <link href="mailto:heidi@kutcha.org">Heidi</link>.
  +      improvements, please email me, <link href="mailto:heidi@kutcha.org">Heidi-Marie
Brannan</link>.
         I will do my upmost to keep this How-To up to date and error free.</p>
       </s1>
     </body>
  
  
  

----------------------------------------------------------------------
In case of troubles, e-mail:     webmaster@xml.apache.org
To unsubscribe, e-mail:          cocoon-cvs-unsubscribe@xml.apache.org
For additional commands, e-mail: cocoon-cvs-help@xml.apache.org


Mime
View raw message