releng: improve site
diff --git a/pom.xml b/pom.xml
index ead294a..99af275 100644
--- a/pom.xml
+++ b/pom.xml
@@ -54,6 +54,7 @@
12343846,12344079,12344332,12344876,12345571,12346551,12346590,12346596,12348677</site.jira.version.id>
<maven.version>3.3.9</maven.version>
<maven.site.path>${project.artifactId}-archives/${project.artifactId}-LATEST</maven.site.path>
+ <sightly.runtime.version>1.2.6-1.4.0</sightly.runtime.version>
<argLine />
<!-- the github id used for the ribbon for Maven sites: https://maven.apache.org/skins/maven-fluido-skin/#GitHub_ribbons -->
<github.project.id>apache/sling-htl-maven-plugin</github.project.id>
@@ -100,7 +101,7 @@
<dependency>
<groupId>org.apache.sling</groupId>
<artifactId>org.apache.sling.scripting.sightly.runtime</artifactId>
- <version>1.2.6-1.4.0</version>
+ <version>${sightly.runtime.version}</version>
</dependency>
<dependency>
<groupId>org.apache.sling</groupId>
diff --git a/src/site/markdown/index.md b/src/site/markdown/index.md
index 9317ce6..6e43582 100644
--- a/src/site/markdown/index.md
+++ b/src/site/markdown/index.md
@@ -1,19 +1,21 @@
-## Apache Sling HTL Maven Plugin
+# Overview
-The Apache Sling HTL Maven Plugin, M2Eclipse compatible, provides support for validating HTML Template Language scripts from projects during
+The Apache Sling HTL Maven Plugin provides support for validating HTML Template Language scripts from projects during
build time, reporting issues like:
* syntax errors;
* expression warnings (e.g. missing required display contexts, sensible attributes with dynamic values, etc.);
-* incorrect usage of block elements.
+* incorrect usage of block elements.
+
+It is compatible with [m2eclipse](https://www.eclipse.org/m2e/documentation/m2e-making-maven-plugins-compat.html) and supports executing its goals during Eclipse incremental builds.
-### Goals
+## Goals
The HTL Maven Plugin has only one goal:
-* [htl:validate](validate-mojo.html) is bound to the compile phase and is used to validate HTL scripts.
+* [htl:validate](validate-mojo.html) is bound to the generate-sources phase and is used to validate/transpile HTL scripts.
-### Usage
+## Usage
General instructions on how to use the HTL Maven Plugin can be found on the [usage](usage.html) page.
In case you still have questions regarding the plugin's usage feel free to contact the Apache Sling Development List. The posts to the
diff --git a/src/site/markdown/usage.md.vm b/src/site/markdown/usage.md.vm
index cf839a6..7cb6c0e 100644
--- a/src/site/markdown/usage.md.vm
+++ b/src/site/markdown/usage.md.vm
@@ -64,7 +64,7 @@
$h3 Generating Java classes from your HTL scripts
Since version 1.1.0 it's possible to generate Java classes from the project's HTL scripts. This is useful when you want to identify your
-script's Java dependencies. To do this the following configuration should be applied:
+script's Java dependencies or precompile scripts. To do this the following configuration should be applied:
```
<project>
@@ -83,7 +83,7 @@
</configuration>
<executions>
<execution>
- <id>validate-scripts</id>
+ <id>transpile-scripts</id>
<goals>
<goal>validate</goal>
</goals>
@@ -91,34 +91,14 @@
</execution>
</executions>
</plugin>
- </plugins>
+ </plugins>
</pluginManagement>
</build>
...
</project>
```
-Additionally, the following dependencies are required as part of your project's dependencies list:
-
-```
-<!-- HTL dependencies needed for the HTL Maven Plugin source code generation -->
-<dependency>
- <groupId>org.apache.sling</groupId>
- <artifactId>org.apache.sling.scripting.sightly.compiler</artifactId>
- <!-- version 1.0.14 or higher -->
- <version>1.0.14</version>
- <scope>provided</scope>
-</dependency>
-<dependency>
- <groupId>org.apache.sling</groupId>
- <artifactId>org.apache.sling.scripting.sightly.compiler.java</artifactId>
- <!-- version 1.0.16 or higher -->
- <version>1.0.16</version>
- <scope>provided</scope>
-</dependency>
-```
-
-Starting with version 1.2.2 of the `htl-maven-plugin`, only the following dependency is needed as part of your project's dependency list:
+Additionally, the following dependency is needed as part of your project's dependency list:
```
<!-- HTL dependencies needed for the HTL Maven Plugin source code generation -->
