You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@velocity.apache.org by cb...@apache.org on 2021/03/08 18:29:00 UTC

[velocity-site] 01/03: [site] Prepare download page for new releases; fix VELOCITY-936

This is an automated email from the ASF dual-hosted git repository.

cbrisson pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/velocity-site.git

commit 565064aee1cb807215e259daa7ef5282d9acea3e
Author: Claude Brisson <cl...@renegat.net>
AuthorDate: Mon Mar 8 19:28:10 2021 +0100

    [site] Prepare download page for new releases; fix VELOCITY-936
---
 src/content/download.mdtext | 226 ++++++++++++++++++++++++++------------------
 1 file changed, 136 insertions(+), 90 deletions(-)

diff --git a/src/content/download.mdtext b/src/content/download.mdtext
index 4c006d8..a724489 100644
--- a/src/content/download.mdtext
+++ b/src/content/download.mdtext
@@ -4,6 +4,8 @@ Title: Apache Velocity - Download Page
 
 You can download sources and binaries for all Apache Velocity projects from here.
 
+[TOC]
+
 ### Mirror Selection
 
 [if-any logo] <a href="[link]"><img src="[logo]" align="right" border="0" alt="logo" /></a>[end]
@@ -16,7 +18,7 @@ The currently selected mirror is <b>[preferred]</b>. If you encounter a problem
         [if-any http]
             [for http]
             <option value="[http]">[http]</option>
-            [end]
+            [end] a
         [end]
         [if-any ftp]
             [for ftp]
@@ -45,18 +47,28 @@ The <tt>SHA</tt> links download the checksum from the main site. None of these s
 
 These releases are considered stable and suitable for production.
 
-### Engine
+### Velocity Engine 2.3
+
+Be sure to check the [release notes](https://www.apache.org/dist/velocity/engine/2.3/release-notes.html) and the [dependencies](https://velocity.apache.org/engine/2.3/dependencies.html).
 
-Be sure to check the [release notes](https://www.apache.org/dist/velocity/engine/2.2/release-notes.html) and the [dependencies](https://velocity.apache.org/engine/2.2/dependencies.html).
+#### Modules
+
++ `velocity-engine-core`, the core templating engine
++ `velocity-engine-scripting`, the JSR223 scripting engine
++ `spring-velocity-support`, Spring framework integration support classes of the engine
++ `velocity-engine-examples`, a zip file of simple examples for the engine
++ `velocity-custom-parser-example`, a `pom.xml` example demonstrating parser customization
 
 #### Inclusion as a maven dependency
 
     <dependency>
       <groupId>org.apache.velocity</groupId>
       <artifactId>velocity-engine-core</artifactId>
-      <version>2.2</version>
+      <version>2.3</version>
     </dependency>
 
+Replace `velocity-engine-core` with `velocity-engine-scripting` to include the scripting engine, or with `spring-velocity-support` to include the Spring integration support. Both will include `velocity-engine-core` as a dependency.
+
 #### Binaries
 
 <table class="smalltable">
@@ -64,16 +76,22 @@ Be sure to check the [release notes](https://www.apache.org/dist/velocity/engine
   </thead>
   <tbody>
     <tr>
-      <th>engine-core</th>
-      <td><a href="[preferred]/velocity/engine/2.2/velocity-engine-core-2.2.jar">velocity-engine-core-2.2.jar</a></td>
-      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-core-2.2.jar.asc">PGP</a>]</td>
-      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-core-2.2.jar.sha256">SHA256</a>]</td>
+      <th>velocity-engine-core</th>
+      <td><a href="[preferred]/velocity/engine/2.3/velocity-engine-core-2.3.jar">velocity-engine-core-2.3.jar</a></td>
+      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-engine-core-2.3.jar.asc">PGP</a>]</td>
+      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-engine-core-2.3.jar.sha256">SHA256</a>]</td>
+    </tr>
+    <tr>
+      <th>velocity-engine-scripting</th>
+      <td><a href="[preferred]/velocity/engine/2.3/velocity-engine-scripting-2.3.jar">velocity-engine-scripting-2.3.jar</a></td>
+      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-engine-scripting-2.3.jar.asc">PGP</a>]</td>
+      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-engine-scripting-2.3.jar.sha256">SHA256</a>]</td>
     </tr>
     <tr>
-      <th>engine-scripting</th>
-      <td><a href="[preferred]/velocity/engine/2.2/velocity-engine-scripting-2.2.jar">velocity-engine-scripting-2.2.jar</a></td>
-      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-scripting-2.2.jar.asc">PGP</a>]</td>
-      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-scripting-2.2.jar.sha256">SHA256</a>]</td>
+      <th>spring-velocity-support</th>
+      <td><a href="[preferred]/velocity/engine/2.3/velocity-spring-velocity-support-2.3.jar">velocity-spring-velocity-support-2.3.jar</a></td>
+      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-spring-velocity-support-2.3.jar.asc">PGP</a>]</td>
+      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-spring-velocity-support-2.3.jar.sha256">SHA256</a>]</td>
     </tr>
   </tbody>
 </table>
@@ -85,22 +103,28 @@ Be sure to check the [release notes](https://www.apache.org/dist/velocity/engine
   </thead>
   <tbody>
     <tr>
-      <th>engine-core</th>
-      <td><a href="[preferred]/velocity/engine/2.2/velocity-engine-core-2.2.pom">velocity-engine-core-2.2.pom</a></td>
-      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-core-2.2.pom.asc">PGP</a>]</td>
-      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-core-2.2.pom.sha256">SHA256</a>]</td>
+      <th>velocity-engine-core</th>
+      <td><a href="[preferred]/velocity/engine/2.3/velocity-engine-core-2.3.pom">velocity-engine-core-2.3.pom</a></td>
+      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-engine-core-2.3.pom.asc">PGP</a>]</td>
+      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-engine-core-2.3.pom.sha256">SHA256</a>]</td>
+    </tr>
+    <tr>
+      <th>velocity-engine-scripting</th>
+      <td><a href="[preferred]/velocity/engine/2.3/velocity-engine-scripting-2.3.pom">velocity-engine-scripting-2.3.pom</a></td>
+      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-engine-scripting-2.3.pom.asc">PGP</a>]</td>
+      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-engine-scripting-2.3.pom.sha256">SHA256</a>]</td>
     </tr>
     <tr>
-      <th>engine-scripting</th>
-      <td><a href="[preferred]/velocity/engine/2.2/velocity-engine-scripting-2.2.pom">velocity-engine-scripting-2.2.pom</a></td>
-      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-scripting-2.2.pom.asc">PGP</a>]</td>
-      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-scripting-2.2.pom.sha256">SHA256</a>]</td>
+      <th>spring-velocity-support</th>
+      <td><a href="[preferred]/velocity/engine/2.3/velocity-spring-velocity-support-2.3.pom">velocity-spring-velocity-support-2.3.pom</a></td>
+      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-spring-velocity-support-2.3.pom.asc">PGP</a>]</td>
+      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-spring-velocity-support-2.3.pom.sha256">SHA256</a>]</td>
     </tr>
     <tr>
       <th>velocity-custom-parser-example</th>
-      <td><a href="[preferred]/velocity/engine/2.2/velocity-custom-parser-example-2.2.pom">velocity-engine-scripting-2.2.pom</a></td>
-      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-custom-parser-example-2.2.pom.asc">PGP</a>]</td>
-      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-custom-parser-example-2.2.pom.sha256">SHA256</a>]</td>
+      <td><a href="[preferred]/velocity/engine/2.3/velocity-custom-parser-example-2.3.pom">velocity-engine-scripting-2.3.pom</a></td>
+      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-custom-parser-example-2.3.pom.asc">PGP</a>]</td>
+      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-custom-parser-example-2.3.pom.sha256">SHA256</a>]</td>
     </tr>
   </tbody>
 </table>
@@ -112,16 +136,22 @@ Be sure to check the [release notes](https://www.apache.org/dist/velocity/engine
   </thead>
   <tbody>
     <tr>
-      <th>engine-core</th>
-      <td><a href="[preferred]/velocity/engine/2.2/velocity-engine-core-2.2-javadoc.jar">velocity-engine-core-2.2-javadoc.jar</a></td>
-      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-core-2.2-javadoc.jar.asc">PGP</a>]</td>
-      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-core-2.2-javadoc.jar.sha256">SHA256</a>]</td>
+      <th>velocity-engine-core</th>
+      <td><a href="[preferred]/velocity/engine/2.3/velocity-engine-core-2.3-javadoc.jar">velocity-engine-core-2.3-javadoc.jar</a></td>
+      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-engine-core-2.3-javadoc.jar.asc">PGP</a>]</td>
+      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-engine-core-2.3-javadoc.jar.sha256">SHA256</a>]</td>
     </tr>
     <tr>
-      <th>engine-scripting</th>
-      <td><a href="[preferred]/velocity/engine/2.2/velocity-engine-scripting-2.2-javadoc.jar">velocity-engine-scripting-2.2-javadoc.jar</a></td>
-      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-scripting-2.2-javadoc.jar.asc">PGP</a>]</td>
-      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-scripting-2.2-javadoc.jar.sha256">SHA256</a>]</td>
+      <th>velocity-engine-scripting</th>
+      <td><a href="[preferred]/velocity/engine/2.3/velocity-engine-scripting-2.3-javadoc.jar">velocity-engine-scripting-2.3-javadoc.jar</a></td>
+      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-engine-scripting-2.3-javadoc.jar.asc">PGP</a>]</td>
+      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-engine-scripting-2.3-javadoc.jar.sha256">SHA256</a>]</td>
+    </tr>
+    <tr>
+      <th>spring-velocity-support</th>
+      <td><a href="[preferred]/velocity/engine/2.3/velocity-spring-velocity-support-2.3-javadoc.jar">velocity-spring-velocity-support-2.3-javadoc.jar</a></td>
+      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-spring-velocity-support-2.3-javadoc.jar.asc">PGP</a>]</td>
+      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-spring-velocity-support-2.3-javadoc.jar.sha256">SHA256</a>]</td>
     </tr>
   </tbody>
 </table>
@@ -133,16 +163,22 @@ Be sure to check the [release notes](https://www.apache.org/dist/velocity/engine
   </thead>
   <tbody>
     <tr>
-      <th>engine-core</th>
-      <td><a href="[preferred]/velocity/engine/2.2/velocity-engine-core-2.2-sources.jar">velocity-engine-core-2.2-sources.jar</a></td>
-      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-core-2.2-sources.jar.asc">PGP</a>]</td>
-      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-core-2.2-sources.jar.sha256">SHA256</a>]</td>
+      <th>velocity-engine-core</th>
+      <td><a href="[preferred]/velocity/engine/2.3/velocity-engine-core-2.3-sources.jar">velocity-engine-core-2.3-sources.jar</a></td>
+      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-engine-core-2.3-sources.jar.asc">PGP</a>]</td>
+      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-engine-core-2.3-sources.jar.sha256">SHA256</a>]</td>
+    </tr>
+    <tr>
+      <th>velocity-engine-scripting</th>
+      <td><a href="[preferred]/velocity/engine/2.3/velocity-engine-scripting-2.3-sources.jar">velocity-engine-scripting-2.3-sources.jar</a></td>
+      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-engine-scripting-2.3-sources.jar.asc">PGP</a>]</td>
+      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-engine-scripting-2.3-sources.jar.sha256">SHA256</a>]</td>
     </tr>
     <tr>
-      <th>engine-scripting</th>
-      <td><a href="[preferred]/velocity/engine/2.2/velocity-engine-scripting-2.2-sources.jar">velocity-engine-scripting-2.2-sources.jar</a></td>
-      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-scripting-2.2-sources.jar.asc">PGP</a>]</td>
-      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-scripting-2.2-sources.jar.sha256">SHA256</a>]</td>
+      <th>spring-velocity-support</th>
+      <td><a href="[preferred]/velocity/engine/2.3/velocity-spring-velocity-support-2.3-sources.jar">velocity-spring-velocity-support-2.3-sources.jar</a></td>
+      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-spring-velocity-support-2.3-sources.jar.asc">PGP</a>]</td>
+      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-spring-velocity-support-2.3-sources.jar.sha256">SHA256</a>]</td>
     </tr>
   </tbody>
 </table>
@@ -155,27 +191,35 @@ Be sure to check the [release notes](https://www.apache.org/dist/velocity/engine
   <tbody>
     <tr>
       <th>velocity-engine-examples</th>
-      <td><a href="[preferred]/velocity/engine/2.2/velocity-engine-examples-2.2.zip">velocity-engine-examples.zip</a></td>
-      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-examples-2.2.zip.asc">PGP</a>]</td>
-      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-examples-2.2.zip.sha256">SHA256</a>]</td>
+      <td><a href="[preferred]/velocity/engine/2.3/velocity-engine-examples-2.3.zip">velocity-engine-examples.zip</a></td>
+      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-engine-examples-2.3.zip.asc">PGP</a>]</td>
+      <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-engine-examples-2.3.zip.sha256">SHA256</a>]</td>
     </tr>
   </tbody>
 </table>
 
-### Tools
+### Velocity Tools 3.1
+
+#### Modules
+
++ `velocity-tools-generic`, the generic tools
++ `velocity-tools-view`, the view tools, meant to be used in a J2EE webapp
++ `velocity-tools-view-jsp`, the view tools JSP extension
 
 #### Inclusion as a maven dependency
 
+Use one of:
+
     <dependency>
       <groupId>org.apache.velocity.tools</groupId>
       <artifactId>velocity-tools-generic</artifactId>
-      <version>3.0</version>
+      <version>3.1</version>
     </dependency>
 
     <dependency>
       <groupId>org.apache.velocity.tools</groupId>
       <artifactId>velocity-tools-view</artifactId>
-      <version>3.0</version>
+      <version>3.1</version>
     </dependency>
 
     <dependency>
@@ -184,6 +228,8 @@ Be sure to check the [release notes](https://www.apache.org/dist/velocity/engine
       <version>3.0</version>
     </dependency>
 
+Each of those modules will include the previous one as a dependency. But note that `velocity-tools-view-jsp` is still in 3.0.
+
 #### Binaries
 
 <table class="smalltable">
@@ -192,18 +238,18 @@ Be sure to check the [release notes](https://www.apache.org/dist/velocity/engine
   <tbody>
     <tr>
       <th>Generic Tools</th>
-      <td><a href="[preferred]/velocity/tools/3.0/velocity-tools-generic-3.0.jar">velocity-tools-generic-3.0.jar</a></td>
-      <td>[<a href="https://www.apache.org/dist/velocity/tools/3.0/velocity-tools-generic-3.0.jar.asc">PGP</a>]</td>
-      <td>[<a href="https://www.apache.org/dist/velocity/tools/3.0/velocity-tools-generic-3.0.jar.sha256">SHA256</a>]</td>
+      <td><a href="[preferred]/velocity/tools/3.1/velocity-tools-generic-3.1.jar">velocity-tools-generic-3.1.jar</a></td>
+      <td>[<a href="https://www.apache.org/dist/velocity/tools/3.1/velocity-tools-generic-3.1.jar.asc">PGP</a>]</td>
+      <td>[<a href="https://www.apache.org/dist/velocity/tools/3.1/velocity-tools-generic-3.1.jar.sha256">SHA256</a>]</td>
     </tr>
     <tr>
       <th>View Tools</th>
-      <td><a href="[preferred]/velocity/tools/3.0/velocity-tools-view-3.0.jar">velocity-tools-view-3.0.jar</a></td>
-      <td>[<a href="https://www.apache.org/dist/velocity/tools/3.0/velocity-tools-view-3.0.jar.asc">PGP</a>]</td>
-      <td>[<a href="https://www.apache.org/dist/velocity/tools/3.0/velocity-tools-view-3.0.jar.sha256">SHA256</a>]</td>
+      <td><a href="[preferred]/velocity/tools/3.1/velocity-tools-view-3.1.jar">velocity-tools-view-3.1.jar</a></td>
+      <td>[<a href="https://www.apache.org/dist/velocity/tools/3.1/velocity-tools-view-3.1.jar.asc">PGP</a>]</td>
+      <td>[<a href="https://www.apache.org/dist/velocity/tools/3.1/velocity-tools-view-3.1.jar.sha256">SHA256</a>]</td>
     </tr>
     <tr>
-      <th>JSP View Tools</th>
+      <th>JSP View Tools (3.0)</th>
       <td><a href="[preferred]/velocity/tools/3.0/velocity-tools-view-jsp-3.0.jar">velocity-tools-view-jsp-3.0.jar</a></td>
       <td>[<a href="https://www.apache.org/dist/velocity/tools/3.0/velocity-tools-view-jsp-3.0.jar.asc">PGP</a>]</td>
       <td>[<a href="https://www.apache.org/dist/velocity/tools/3.0/velocity-tools-view-jsp-3.0.jar.sha256">SHA256</a>]</td>
@@ -219,18 +265,18 @@ Be sure to check the [release notes](https://www.apache.org/dist/velocity/engine
   <tbody>
     <tr>
       <th>Generic Tools</th>
-      <td><a href="[preferred]/velocity/tools/3.0/velocity-tools-generic-3.0.pom">velocity-tools-generic-3.0.pom</a></td>
-      <td>[<a href="https://www.apache.org/dist/velocity/tools/3.0/velocity-tools-generic-3.0.pom.asc">PGP</a>]</td>
-      <td>[<a href="https://www.apache.org/dist/velocity/tools/3.0/velocity-tools-generic-3.0.pom.sha256">SHA256</a>]</td>
+      <td><a href="[preferred]/velocity/tools/3.1/velocity-tools-generic-3.1.pom">velocity-tools-generic-3.1.pom</a></td>
+      <td>[<a href="https://www.apache.org/dist/velocity/tools/3.1/velocity-tools-generic-3.1.pom.asc">PGP</a>]</td>
+      <td>[<a href="https://www.apache.org/dist/velocity/tools/3.1/velocity-tools-generic-3.1.pom.sha256">SHA256</a>]</td>
     </tr>
     <tr>
       <th>View Tools</th>
-      <td><a href="[preferred]/velocity/tools/3.0/velocity-tools-view-3.0.pom">velocity-tools-view-3.0.pom</a></td>
-      <td>[<a href="https://www.apache.org/dist/velocity/tools/3.0/velocity-tools-view-3.0.pom.asc">PGP</a>]</td>
-      <td>[<a href="https://www.apache.org/dist/velocity/tools/3.0/velocity-tools-view-3.0.pom.sha256">SHA256</a>]</td>
+      <td><a href="[preferred]/velocity/tools/3.1/velocity-tools-view-3.1.pom">velocity-tools-view-3.1.pom</a></td>
+      <td>[<a href="https://www.apache.org/dist/velocity/tools/3.1/velocity-tools-view-3.1.pom.asc">PGP</a>]</td>
+      <td>[<a href="https://www.apache.org/dist/velocity/tools/3.1/velocity-tools-view-3.1.pom.sha256">SHA256</a>]</td>
     </tr>
     <tr>
-      <th>JSP View Tools</th>
+      <th>JSP View Tools (3.0)</th>
       <td><a href="[preferred]/velocity/tools/3.0/velocity-tools-view-jsp-3.0.pom">velocity-tools-view-jsp-3.0.pom</a></td>
       <td>[<a href="https://www.apache.org/dist/velocity/tools/3.0/velocity-tools-view-jsp-3.0.pom.asc">PGP</a>]</td>
       <td>[<a href="https://www.apache.org/dist/velocity/tools/3.0/velocity-tools-view-jsp-3.0.pom.sha256">SHA256</a>]</td>
@@ -246,18 +292,18 @@ Be sure to check the [release notes](https://www.apache.org/dist/velocity/engine
   <tbody>
     <tr>
       <th>Generic Tools</th>
-      <td><a href="[preferred]/velocity/tools/3.0/velocity-tools-generic-3.0-javadoc.jar">velocity-tools-generic-3.0-javadoc.jar</a></td>
-      <td>[<a href="https://www.apache.org/dist/velocity/tools/3.0/velocity-tools-generic-3.0-javadoc.jar.asc">PGP</a>]</td>
-      <td>[<a href="https://www.apache.org/dist/velocity/tools/3.0/velocity-tools-generic-3.0-javadoc.jar.sha256">SHA256</a>]</td>
+      <td><a href="[preferred]/velocity/tools/3.1/velocity-tools-generic-3.1-javadoc.jar">velocity-tools-generic-3.1-javadoc.jar</a></td>
+      <td>[<a href="https://www.apache.org/dist/velocity/tools/3.1/velocity-tools-generic-3.1-javadoc.jar.asc">PGP</a>]</td>
+      <td>[<a href="https://www.apache.org/dist/velocity/tools/3.1/velocity-tools-generic-3.1-javadoc.jar.sha256">SHA256</a>]</td>
     </tr>
     <tr>
       <th>View Tools</th>
-      <td><a href="[preferred]/velocity/tools/3.0/velocity-tools-view-3.0-javadoc.jar">velocity-tools-view-3.0-javadoc.jar</a></td>
-      <td>[<a href="https://www.apache.org/dist/velocity/tools/3.0/velocity-tools-view-3.0-javadoc.jar.asc">PGP</a>]</td>
-      <td>[<a href="https://www.apache.org/dist/velocity/tools/3.0/velocity-tools-view-3.0-javadoc.jar.sha256">SHA256</a>]</td>
+      <td><a href="[preferred]/velocity/tools/3.1/velocity-tools-view-3.1-javadoc.jar">velocity-tools-view-3.1-javadoc.jar</a></td>
+      <td>[<a href="https://www.apache.org/dist/velocity/tools/3.1/velocity-tools-view-3.1-javadoc.jar.asc">PGP</a>]</td>
+      <td>[<a href="https://www.apache.org/dist/velocity/tools/3.1/velocity-tools-view-3.1-javadoc.jar.sha256">SHA256</a>]</td>
     </tr>
     <tr>
-      <th>JSP View Tools</th>
+      <th>JSP View Tools (3.0)</th>
       <td><a href="[preferred]/velocity/tools/3.0/velocity-tools-view-jsp-3.0-javadoc.jar">velocity-tools-view-jsp-3.0-javadoc.jar</a></td>
       <td>[<a href="https://www.apache.org/dist/velocity/tools/3.0/velocity-tools-view-jsp-3.0-javadoc.jar.asc">PGP</a>]</td>
       <td>[<a href="https://www.apache.org/dist/velocity/tools/3.0/velocity-tools-view-jsp-3.0-javadoc.jar.sha256">SHA256</a>]</td>
@@ -273,18 +319,18 @@ Be sure to check the [release notes](https://www.apache.org/dist/velocity/engine
   <tbody>
     <tr>
       <th>Generic Tools</th>
-      <td><a href="[preferred]/velocity/tools/3.0/velocity-tools-generic-3.0-sources.jar">velocity-tools-generic-3.0-sources.jar</a></td>
-      <td>[<a href="https://www.apache.org/dist/velocity/tools/3.0/velocity-tools-generic-3.0-sources.jar.asc">PGP</a>]</td>
-      <td>[<a href="https://www.apache.org/dist/velocity/tools/3.0/velocity-tools-generic-3.0-sources.jar.sha256">SHA256</a>]</td>
+      <td><a href="[preferred]/velocity/tools/3.1/velocity-tools-generic-3.1-sources.jar">velocity-tools-generic-3.1-sources.jar</a></td>
+      <td>[<a href="https://www.apache.org/dist/velocity/tools/3.1/velocity-tools-generic-3.1-sources.jar.asc">PGP</a>]</td>
+      <td>[<a href="https://www.apache.org/dist/velocity/tools/3.1/velocity-tools-generic-3.1-sources.jar.sha256">SHA256</a>]</td>
     </tr>
     <tr>
       <th>View Tools</th>
-      <td><a href="[preferred]/velocity/tools/3.0/velocity-tools-view-3.0-sources.jar">velocity-tools-view-3.0-sources.jar</a></td>
-      <td>[<a href="https://www.apache.org/dist/velocity/tools/3.0/velocity-tools-view-3.0-sources.jar.asc">PGP</a>]</td>
-      <td>[<a href="https://www.apache.org/dist/velocity/tools/3.0/velocity-tools-view-3.0-sources.jar.sha256">SHA256</a>]</td>
+      <td><a href="[preferred]/velocity/tools/3.1/velocity-tools-view-3.1-sources.jar">velocity-tools-view-3.1-sources.jar</a></td>
+      <td>[<a href="https://www.apache.org/dist/velocity/tools/3.1/velocity-tools-view-3.1-sources.jar.asc">PGP</a>]</td>
+      <td>[<a href="https://www.apache.org/dist/velocity/tools/3.1/velocity-tools-view-3.1-sources.jar.sha256">SHA256</a>]</td>
     </tr>
     <tr>
-      <th>JSP View Tools</th>
+      <th>JSP View Tools (3.0)</th>
       <td><a href="[preferred]/velocity/tools/3.0/velocity-tools-view-jsp-3.0-sources.jar">velocity-tools-view-jsp-3.0-sources.jar</a></td>
       <td>[<a href="https://www.apache.org/dist/velocity/tools/3.0/velocity-tools-view-jsp-3.0-sources.jar.asc">PGP</a>]</td>
       <td>[<a href="https://www.apache.org/dist/velocity/tools/3.0/velocity-tools-view-jsp-3.0-sources.jar.sha256">SHA256</a>]</td>
@@ -292,7 +338,12 @@ Be sure to check the [release notes](https://www.apache.org/dist/velocity/engine
   </tbody>
 </table>
 
-Or checkout the svn repository from [the 3.0 subversion tag](https://svn.apache.org/repos/asf/velocity/tools/tags/3.0).
+Or clone the github mirror repository and checkout the 3.1 tag:
+
+    :::shell
+    git clone https://github.com/apache/velocity-tools
+    cd velocity-tools
+    git checkout tags/3.1
 
 ---
 
@@ -300,47 +351,43 @@ Or checkout the svn repository from [the 3.0 subversion tag](https://svn.apache.
 
 These releases are not considered production-ready but they might contain new features or bug fixes that are not yet in the production release.
 
-## Engine
+### Engine
 
 There are no current Alpha or Beta releases of the Engine project.
 
-## Tools
+### Tools
 
 There are no current Alpha or Beta releases of the Tools project.
 
 ---
 
-## Snapshot Releases
-
-Snapshot releases published from times to times on [Apache's repository](https://repository.apache.org/content/repositories/snapshots/org/apache/velocity/).
-
 ## Archived Components Releases
 
 ### Anakia
 
 Binaries and sources:
 
-+ [anakia-1.0.zip]([preferred]/velocity/anakia/1.0/anakia-1.0.zip) [[PGP](https://www.apache.org/dist/velocity/anakia/1.0/anakia-1.0.zip.asc)] [[SHA1](https://www.apache.org/dist/velocity/anakia/1.0/anakia-1.0.zip.sha1)]
-+ [anakia-1.0.tar.gz]([preferred]/velocity/anakia/1.0/anakia-1.0.tar.gz) [[PGP](https://www.apache.org/dist/velocity/anakia/1.0/anakia-1.0.tar.gz.asc)] [[SHA1](https://www.apache.org/dist/velocity/anakia/1.0/anakia-1.0.tar.gz.sha1)]
++ [anakia-1.0.zip](https://archive.apache.org/dist/velocity/anakia/1.0/anakia-1.0.zip) [[PGP](https://archive.apache.org/dist/velocity/anakia/1.0/anakia-1.0.zip.asc)] [[SHA1](https://archive.apache.org/dist/velocity/anakia/1.0/anakia-1.0.zip.sha1)]
++ [anakia-1.0.tar.gz](https://archive.apache.org/dist/velocity/anakia/1.0/anakia-1.0.tar.gz) [[PGP](https://archive.apache.org/dist/velocity/anakia/1.0/anakia-1.0.tar.gz.asc)] [[SHA1](https://archive.apache.org/dist/velocity/anakia/1.0/anakia-1.0.tar.gz.sha1)]
 
 ### Texen
 
 Binaries and sources:
 
-+ [texen-1.0.zip]([preferred]/velocity/texen/1.0/texen-1.0.zip) [[PGP](https://www.apache.org/dist/velocity/texen/1.0/texen-1.0.zip.asc)] [[SHA1](https://www.apache.org/dist/velocity/texen/1.0/texen-1.0.zip.sha1)]
-+ [texen-1.0.tar.gz]([preferred]/velocity/texen/1.0/texen-1.0.tar.gz) [[PGP](https://www.apache.org/dist/velocity/texen/1.0/texen-1.0.tar.gz.asc)] [[SHA1](https://www.apache.org/dist/velocity/texen/1.0/texen-1.0.tar.gz.sha1)]
++ [texen-1.0.zip](https://archive.apache.org/dist/velocity/texen/1.0/texen-1.0.zip) [[PGP](https://archive.apache.org/dist/velocity/texen/1.0/texen-1.0.zip.asc)] [[SHA1](https://archive.apache.org/dist/velocity/texen/1.0/texen-1.0.zip.sha1)]
++ [texen-1.0.tar.gz](https://archive.apache.org/dist/velocity/texen/1.0/texen-1.0.tar.gz) [[PGP](https://archive.apache.org/dist/velocity/texen/1.0/texen-1.0.tar.gz.asc)] [[SHA1](https://archive.apache.org/dist/velocity/texen/1.0/texen-1.0.tar.gz.sha1)]
 
 ### DVSL
 
 Binaries:
 
-+ [velocity-dvsl-1.0.zip]([preferred]/velocity/dvsl/1.0/velocity-dvsl-1.0.zip) [[PGP](https://www.apache.org/dist/velocity/dvsl/1.0/velocity-dvsl-1.0.zip.asc)] [[SHA1](https://www.apache.org/dist/velocity/dvsl/1.0/velocity-dvsl-1.0.zip.sha1)]
-+ [velocity-dvsl-1.0.tar.gz]([preferred]/velocity/dvsl/1.0/velocity-dvsl-1.0.tar.gz) [[PGP](https://www.apache.org/dist/velocity/dvsl/1.0/velocity-dvsl-1.0.tar.gz.asc)] [[SHA1](https://www.apache.org/dist/velocity/dvsl/1.0/velocity-dvsl-1.0.tar.gz.sha1)]
++ [velocity-dvsl-1.0.zip](https://archive.apache.org/dist/velocity/dvsl/1.0/velocity-dvsl-1.0.zip) [[PGP](https://archive.apache.org/dist/velocity/dvsl/1.0/velocity-dvsl-1.0.zip.asc)] [[SHA1](https://archive.apache.org/dist/velocity/dvsl/1.0/velocity-dvsl-1.0.zip.sha1)]
++ [velocity-dvsl-1.0.tar.gz](https://archive.apache.org/dist/velocity/dvsl/1.0/velocity-dvsl-1.0.tar.gz) [[PGP](https://archive.apache.org/dist/velocity/dvsl/1.0/velocity-dvsl-1.0.tar.gz.asc)] [[SHA1](https://archive.apache.org/dist/velocity/dvsl/1.0/velocity-dvsl-1.0.tar.gz.sha1)]
 
 Sources:
 
-+ [velocity-dvsl-1.0-src.zip]([preferred]/velocity/dvsl/1.0/velocity-dvsl-1.0-src.zip) [[PGP](https://www.apache.org/dist/velocity/dvsl/1.0/velocity-dvsl-1.0-src.zip.asc)] [[SHA1](https://www.apache.org/dist/velocity/dvsl/1.0/velocity-dvsl-1.0-src.zip.sha1)]
-+ [velocity-dvsl-1.0-src.tar.gz]([preferred]/velocity/dvsl/1.0/velocity-dvsl-1.0-src.tar.gz) [[PGP](https://www.apache.org/dist/velocity/dvsl/1.0/velocity-dvsl-1.0-src.tar.gz.asc)] [[SHA1](https://www.apache.org/dist/velocity/dvsl/1.0/velocity-dvsl-1.0-src.tar.gz.sha1)]
++ [velocity-dvsl-1.0-src.zip](https://archive.apache.org/dist/velocity/dvsl/1.0/velocity-dvsl-1.0-src.zip) [[PGP](https://archive.apache.org/dist/velocity/dvsl/1.0/velocity-dvsl-1.0-src.zip.asc)] [[SHA1](https://archive.apache.org/dist/velocity/dvsl/1.0/velocity-dvsl-1.0-src.zip.sha1)]
++ [velocity-dvsl-1.0-src.tar.gz](https://archive.apache.org/dist/velocity/dvsl/1.0/velocity-dvsl-1.0-src.tar.gz) [[PGP](https://archive.apache.org/dist/velocity/dvsl/1.0/velocity-dvsl-1.0-src.tar.gz.asc)] [[SHA1](https://archive.apache.org/dist/velocity/dvsl/1.0/velocity-dvsl-1.0-src.tar.gz.sha1)]
 
 ## Older Releases
 
@@ -349,14 +396,13 @@ Older versions of the Apache Velocity projects are available from [our archive s
 * [Engine old versions documentation](/engine/#older-releases)
 * [Tools old versions documentation](/tools/#older-releases)
 
-
 Unless otherwise stated, the most current release of the Apache Velocity projects is considered the *best* release and should be used for development and new projects. These older releases are mainly for maintenance purposes and archaeological interests.
 
 <!-- nightly builds -->
 
 ## Source Code Repository
 
-You can download the source code to each Apache Velocity project directly from our apache gitbox repositories or from our github mirrors (which are preferable to open a pull request). Here you get logs, change histories and all the information necessary to follow the development process. If you are interested in the project development, please join the Apache Velocity development list.
+You can download the source code to each Apache Velocity project directly from our apache gitbox repositories or from our github mirrors (which are preferable if you intend to open a pull request). Here you get logs, change histories and all the information necessary to follow the development process. If you are interested in the project development, please join the Apache Velocity development list.
 
 Project | Apache Gitbox Repository | Github Repository
 --------|----------------|--------------------------