h2. Documentation Pages

Welcome to the Tapestry 5 Documentation.  A rich collection of guides is available to teach beginners the basics and help experienced developers deepen their understanding of Tapestry's power. _Code less, deliver more!_

h1. Highlights

These are the most useful starting points for common needs.

| [Introduction] | An overview of Tapestry's general approach and philosophy |
| [Getting Started]\\ | A quick guide to creating your first Tapestry project, using Maven |
| [Tapestry Tutorial]\\ | Picks up where _Getting Started_ leaves off, explaining in greater detail how Tapestry works |
| [User Guide]\\ | Detailed articles on every Tapestry feature |
| [Community] | Getting support, mailing lists, JIRA, outside resources, and access to the source |
| [Cookbook]\\ | A guide to common overrides and extensions to Tapestry |
| *[FAQ|Frequently Asked Questions]*\\ | A quick place to check for common problems and solutions |
| [Component Cheat Sheet]\\ | A concise guide to component classes, methods and annotations |
| [Refcard|http://refcardz.dzone.com/refcardz/apache-tapestry-50?oid=hom7948]\\ | A color, six page foldout guide to Tapestry 5.0 (PDF) |

h1. Tapestry 5 Reference and API

* Current _release candidate_ 5.3
** [API (Javadoc)|http://tapestry.apache.org/5.3/apidocs/]
** Component Reference: [Categorized|Component Reference] \| [Ordered by Name|http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/package-summary.html]
** [Release Notes|Release Notes 5.3]

* Current stable release 5.2.6
** [API (Javadoc)|http://tapestry.apache.org/5.2/apidocs/]
** [Component Reference|http://tapestry.apache.org/5.2/tapestry-core/ref/]
** [Release Notes|Release Notes 5.2]

* Previous stable release
** [API (Javadoc)|http://tapestry.apache.org/tapestry5.1/apidocs/]
** [Component Reference|http://tapestry.apache.org/tapestry5.1/tapestry-core/ref/]
** [Release Notes|Release Notes 5.1]

* Previous stable release 5.0.19
** [API (Javadoc)|http://tapestry.apache.org/tapestry5.0/apidocs/]
** [Component Reference|http://tapestry.apache.org/tapestry5.0/tapestry-core/ref/]
** [Release Notes|Release Notes 5.0]

h1. User Guide

{anchor:userguide}The [User Guide] consists of over 75 pages of detailed information on the concepts behind Tapestry and instructions on how to use this powerful tool.  Highlights include:

* [JavaScript] and [Ajax and Zones] describe Tapestry's built-in support for dynamic in-page behavior.
* [Integrating with Spring Framework] describes how to integrate Spring into your Tapestry application.
* [Tapestry/Hibernate Integration Library|Hibernate] provides out-of-the-box support for using Hibernate 3.
* [JSR 303: Bean Validation|Bean Validation] shows how to use standard annotations for validation
* [Integration Testing] shows how to test your application with Selenium.

[More topics|User Guide]...

h1. Published Articles on Tapestry 

* This [eBook|http://www.laliluna.de/articles/the-web-framework-evaluation.html] published in 2009 contains a [good introduction and analysis of Tapestry 5|http://www.laliluna.de/articles/2009/08/14/tapestry-web-framework-evaluation-and-test.html]

* [Tapestry 5 for Nonbelievers|http://www.infoq.com/articles/tapestry5-intro] will convince the skeptical why Tapestry is the best web framework.

[More articles|Articles]...

h1. Blogs by Tapestry Developers and the Community

* [Tapestry Central|http://tapestryjava.blogspot.com/] is Howard Lewis Ship's blog. As the creator of Tapestry, he provides valuable insights into Tapestry's latest features and future directions.
* [Igor Drobiazko's blog|http://blog.tapestry5.de/] (committer & PMC) contains news on Tapestry development and will guide you through some of the most exciting parts of Tapestry.
* [Java Magic|http://tawus.wordpress.com/] (by Taha Hafeez, committer) has a series of tutorials illustrating some of the more advanced Tapestry and Plastic features and techniques.
* [Andreas Andreou's blog|http://blog.andyhot.gr/tag/tapestry/] (committer & PMC) has news and commentary on Tapestry.
* [Spread the Source blog|http://spreadthesource.com/] (Christophe Cordenier and Robin Komiwes committers's blog) has news and advanced tutorials on Tapestry 5.

h1. Books on Tapestry

There are at least 8 published [books on Tapestry|TAPESTRY:Books], including two on Tapestry 5 --- and more on the way.

h1. Tapestry Presentations

* [JavaServer Faces 2.0 vs. Tapestry 5|http://jazoon.com/Portals/0/Content/slides/th_a7_1130-1220_drobiazko.pdf] (PDF) A Head-to-Head Comparison by Igor Drobiazko at Jazoon 2010
* [Tapestry 5: Java power, Scripting Ease|http://www.parleys.com/#st=5&sl=5&id=1700] (VIDEO) by Howard Lewis Ship at Devoxx 2009

[More presentations|Presentations] ...

h1. Tapestry Wikis

* [Community's Wiki|http://wiki.apache.org/tapestry/FrontPage] (Moin Moin) contains a lot of user-generated information on different concrete web application use cases.
* [Documentation Source wiki|https://cwiki.apache.org/confluence/x/VCFkAQ] (Confluence) -- the wiki used as the content editor for the official Tapestry documentation

h1. Getting help

The primary method of support is the [Tapestry Mailing Lists|Mailing Lists].

In addition, there is an active flow of questions and answers about Tapestry at [Stack Overflow|http://stackoverflow.com/questions/tagged/tapestry].

h1. The Developer Corner

[Developer Information] gives information needed by the Tapestry developers

<!-- 5 -->