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's How-To</title>
<authors>
- <person name="Heidi Brannan"
+ <person name="Heidi-Marie Brannan"
email="[EMAIL PROTECTED]" />
</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's easy. As for quick, well, it depends on your
- reader, doesn't it? XMLForm introduces a *lot* of stuff that your
- readers may not have dealt with yet. Once you'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'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'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'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:[EMAIL PROTECTED]";>me</link>. I will try
- to help you. Again, please send the entire error message and all
- relevant information. Please use the title "XMLForm Help" 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's white paper for more information.</p>
+ Avalon'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:[EMAIL PROTECTED]";>Heidi</link>.
+ improvements, please email me, <link
href="mailto:[EMAIL PROTECTED]";>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: [EMAIL PROTECTED]
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
