http://thread.gmane.org/gmane.comp.apache.tiles.devel/233
git-svn-id: https://svn.apache.org/repos/asf/tiles/framework/trunk@1162444 13f79535-47bb-0310-9956-ffa450edef68
diff --git a/tiles-autotag/src/site/xdoc/index.xml b/tiles-autotag/src/site/xdoc/index.xml
new file mode 100644
index 0000000..824dc4e
--- /dev/null
+++ b/tiles-autotag/src/site/xdoc/index.xml
@@ -0,0 +1,57 @@
+<?xml version="1.0"?>
+<!--
+/*
+ * $Id: index.xml 1162124 2011-08-26 14:16:13Z mck $
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements. See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership. The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+-->
+<document>
+
+ <properties>
+ <title>Home</title>
+ </properties>
+
+ <body>
+
+ <section name="Apache Autotag™ project">
+
+ <p>Tiles-3 introduces a feature complete
+ <a href="http://svn.eu.apache.org/repos/asf/tiles/sandbox/trunk/tiles-autotag/" title="Autotag SVN directory">Autotag project</a>,
+ a project that automatically generates tags (or tag-like) artifact from a common template code for a range of templating languages.
+ Today JSP tags, Freemarker directive models and Velocity directives are generated from a common template models.
+ </p>
+ <p>Such template models must have a single public method, with this signature:</p>
+ <p>
+ <span class="Apple-style-span" style="font-family: monospace; white-space: pre;">public void execute(<parameters>, Request request, ModelBody modelBody);</span>
+ </p>
+ <p>The modelBody parameter is optional: if it is not specified, the template model does not have a body. </p>
+ <p>For more features (required fields, default values, a name different to the one specified in the parameter list) a new annotation @Parameter has been created.</p>
+ <p>A Maven 2 (based on 2.2.1) plugin contains four Mojos:</p>
+ <p> </p>
+ <ul>
+ <li>the first mojo (create-descriptor) reads the template models and produces an XML file containing the description of the read models;</li>
+ <li>the others (generate-jsp, generate-freemarker, generate-velocity) produce boilerplate code.</li>
+ </ul>
+ <p>The projects using the latter mojos must include some runtime dependencies.</p>
+ <p>The result boilerplate code has been removed and uses the plugin instead: it's a lot of boilerplate, boring code, now generated automatically.
+ </p>
+ </section>
+ </body>
+
+</document>
diff --git a/tiles-parent/src/site/apt/whats-new.apt b/tiles-parent/src/site/apt/whats-new.apt
index 51ac018..2727997 100644
--- a/tiles-parent/src/site/apt/whats-new.apt
+++ b/tiles-parent/src/site/apt/whats-new.apt
@@ -22,8 +22,18 @@
-----------
What's new in Tiles 3.0
- TODO...
+* New features in Tiles 3.0
+
+ * Apache Request: a framework independent request abstraction. Implementations for Servlet, Portlet, JSP, Velocity and FreeMarker.
+
+ * Apache Autotag: a project that automatically generates tags (or tag-like) artifact from a common template code for a range of templating languages.
+ All the Tiles 3 boilerplate code to templating models has been removed and uses the Autotag plugins instead:
+ it's a lot of boilerplate, boring code, now generated automatically.
+
+* Deprecations in Tiles 3.0
+
+ ...todo...
What's new in Tiles 2.2
diff --git a/tiles-request/src/site/xdoc/index.xml b/tiles-request/src/site/xdoc/index.xml
new file mode 100644
index 0000000..df44548
--- /dev/null
+++ b/tiles-request/src/site/xdoc/index.xml
@@ -0,0 +1,51 @@
+<?xml version="1.0"?>
+<!--
+/*
+ * $Id: index.xml 1162124 2011-08-26 14:16:13Z mck $
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements. See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership. The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+-->
+<document>
+
+ <properties>
+ <title>Home</title>
+ </properties>
+
+ <body>
+
+ <section name="Apache Request™ microframework project">
+
+ <p>Tiles-3 introduces a complete standalone and super simple abstraction around request/response objects.
+ <p>We've all seen that the various technologies like Servlet, Portlet, JSP, Velocity, FreeMarker seem to have a different abstraction of a common pattern.
+ They all have a concept of:</p>
+ <ul>
+ <li>request: the client request, or some sort of it;</li>
+ <li>response: the response to send to the client, or to the caller, with a writer/output stream to write into;</li>
+ <li>attributes: usually maps (or map-like structures) with string keys and object values;</li>
+ <li>scope: places where different attribute maps are stored (request, session, etc.)</li>
+ </ul>
+ <p>Now all of these scopes are concentrated into "Request" interfaces, that acts as a single point of reference for the developer.
+ In theory, everything can be obtained by an object that implements Request.</p>
+ <p> </p>
+ <p>Currently there are bindings for Servlet, Portlet, JSP, Velocity and FreeMarker.</p></p>
+
+ </section>
+ </body>
+
+</document>