[TAPESTRY-1973] Tapestry 5 Tutorial Improvements

• Type: Improvement
• Status: Closed
• Priority: Trivial
• Resolution: Fixed
• Affects Version/s: 5.0.7
• Fix Version/s: 5.0.7
• Component/s: Documentation
• Environment: not applicable
• Assignee: Howard Lewis Ship
• Reporter: Reid Sanford
• Created: 12/Dec/07 00:21
• Updated: 22/Dec/07 16:07
• Resolved: 22/Dec/07 16:07

Description

I just got done with the Tapestry 5 Tutorial. Awesome! Here are some recommended improvements. Mostly typos, but also some useful information for poor saps like me who are behind a firewall.

==================================================================

Tapestry Tutorial: Introduction

What is Tapestry?

change "the better of you may be" to "the better off you may be"

Chapter 1: Setting Up Your Environment

Jetty Launcher

Please add the following:

If you are behind a firewall, you will need to set up a manual proxy configuration in Eclipse (Window, Preferences..., General, Network Connections)

Chapter 2: Your First Tapestry Application

Please add the following:

If you are behind a firewall, before running any "mvn" commands, you will need to configure your proxy settings in settings.xml. Here is an example:

<settings>
<proxies>
<proxy>
<active>true</active>
<protocol>http</protocol>
<host>myProxyServer.com</host>
<port>8080</port>
<username>joeuser</username>
<password>myPassword</password>
<nonProxyHosts></nonProxyHosts>
</proxy>
</proxies>
<localRepository>C:/Documents and Settings/joeuser/.m2/repository</localRepository>
</settings>

The URL for the tutorial app is incorrect and should be http://localhost:8080/tapestry-tutorial1/

Change "short and sweet: ou can see" to "short and sweet: you can see"

There is no src/main/webapp/Start.tml, but there is a src/main/webapp/WEB-INF/Start.html

Change "You do have to mee the" to "You do have to meet the"

Change "This one of Tapestry's early" to "This is one of Tapestry's early"

Change "get in the way of you getting our job done" to "get in the way of you getting your job done"

Chapter 3: Implementing the Hi/Lo Guessing Game

Change "make sure is the the Guess page" to "make sure it is the Guess page"

Change "At issue here is the how" to "At issue here is how"

Change "Tapestry determine what page" to "Tapestry determines what page"

When you add the Persist annotation, you also need the import statement:
import org.apache.tapestry.annotations.Persist;

Change "this approach, the user of redirects" to "this approach, the use of redirects"

Change "What would it take to change the the game" to "What would it take to change the game"

Chapter 4: Forms in Tapestry

Change "for editting them" to "for editing them"

Change "seperated with an equals sign" to "separated with an equals sign"

@Validate requires an import statement (import org.apache.tapestry.beaneditor.Validate

Change "submits succesfully" to "submits successfully"