Improvements to the Jetty documentation.

Moved all old documentation under old_docs/.
Generating a small index.html that points to the guides and the old documentation.

Signed-off-by: Simone Bordet <simone.bordet@gmail.com>

jetty-documentation/pom.xml

@@ -127,6 +127,18 @@
           </attributes>
         </configuration>
         <executions>
+          <execution>
+            <id>index</id>
+            <phase>generate-resources</phase>
+            <goals>
+              <goal>process-asciidoc</goal>
+            </goals>
+            <configuration>
+              <sourceDirectory>src/main/asciidoc</sourceDirectory>
+              <sourceDocumentName>index.adoc</sourceDocumentName>
+              <outputDirectory>${project.build.directory}/html</outputDirectory>
+            </configuration>
+          </execution>
           <execution>
             <id>operations-guide</id>
             <phase>generate-resources</phase>
@@ -163,6 +175,18 @@
               <outputDirectory>${project.build.directory}/html/programming-guide</outputDirectory>
             </configuration>
           </execution>
+          <execution>
+            <id>old_docs</id>
+            <phase>prepare-package</phase>
+            <goals>
+              <goal>process-asciidoc</goal>
+            </goals>
+            <configuration>
+              <sourceDirectory>${basedir}/src/main/asciidoc/old_docs</sourceDirectory>
+              <sourceDocumentName>index.adoc</sourceDocumentName>
+              <outputDirectory>${project.build.directory}/html/old_docs</outputDirectory>
+            </configuration>
+          </execution>
         </executions>
       </plugin>
       <plugin>

jetty-documentation/src/main/asciidoc/config.adoc

@@ -36,6 +36,3 @@ ifdef::backend-html5[]
 :safe-mode-unsafe:
 :linkcss:
 endif::[]
-
-// TODO: remove this attribute once all documentation has been ported.
-:sub-order: attributes+

jetty-documentation/src/main/asciidoc/index.adoc

@@ -0,0 +1,39 @@
+//
+// ========================================================================
+// Copyright (c) 1995-2020 Mort Bay Consulting Pty Ltd and others.
+//
+// This program and the accompanying materials are made available under
+// the terms of the Eclipse Public License 2.0 which is available at
+// https://www.eclipse.org/legal/epl-2.0
+//
+// This Source Code may also be made available under the following
+// Secondary Licenses when the conditions for such availability set
+// forth in the Eclipse Public License, v. 2.0 are satisfied:
+// the Apache License v2.0 which is available at
+// https://www.apache.org/licenses/LICENSE-2.0
+//
+// SPDX-License-Identifier: EPL-2.0 OR Apache-2.0
+// ========================================================================
+//
+
+:doctitle: Eclipse Jetty Documentation
+
+include::config.adoc[]
+
+== xref:operations-guide/index.adoc[Jetty Operations Guide]
+
+The Eclipse Jetty Operations Guide targets sysops, devops, and developers who want to install Eclipse Jetty as a standalone server to deploy web applications.
+
+== xref:programming-guide/index.adoc[Jetty Programming Guide]
+
+The Eclipse Jetty Programming Guide targets developers who want to use the Eclipse Jetty libraries in their applications, and advanced sysops/devops that want to customize the deployment of web applications.
+
+== xref:contribution-guide/index.adoc[Jetty Contribution Guide]
+
+The Eclipse Jetty Programming Guide targets developers that wish to contribute to the Jetty Project with code patches or documentation improvements.
+
+== xref:old_docs/index.adoc[OLD Jetty Documentation]
+
+The guides above are a work in progress for the current Jetty version.
+
+The old Jetty documentation refers to old Jetty versions, and it is currently being ported to the current Jetty version.