[MSCRIPTING-5] Links on about page not working
diff --git a/src/site/fml/faq.fml b/src/site/fml/faq.fml
new file mode 100644
index 0000000..257c4d4
--- /dev/null
+++ b/src/site/fml/faq.fml
@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!--
+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.
+-->
+
+
+<faqs xmlns="http://maven.apache.org/FML/1.0.1"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://maven.apache.org/FML/1.0.1 http://maven.apache.org/xsd/fml-1.0.1.xsd"
+  id="FAQ" title="Frequently Asked Questions">
+  
+</faqs>
\ No newline at end of file
diff --git a/src/site/markdown/index.md.vm b/src/site/markdown/index.md.vm
index 705ae37..598af0d 100644
--- a/src/site/markdown/index.md.vm
+++ b/src/site/markdown/index.md.vm
@@ -34,18 +34,18 @@
   [usage page](./usage.html). 
 
   In case you still have questions regarding the plugin's usage, please have a look at the 
-  [FAQ](./faq.html) and feel free to contact the [user mailing list](./mail-lists.html). 
+  [FAQ](./faq.html) and feel free to contact the [user mailing list](./mailing-lists.html). 
   The posts to the mailing list are archived and could already contain the answer to your 
   question as part of an older thread. Hence, it is also worth browsing/searching
-  the [mail archive](./mail-lists.html).
+  the [mail archive](./mailing-lists.html).
 
   If you feel like the plugin is missing a feature or has a defect, you can fill a 
-  feature request or bug report in our [issue tracker](./issue-tracking.html). 
+  feature request or bug report in our [issue tracker](./issue-management.html). 
   When creating a new issue, please provide a comprehensive description of your
   concern. Especially for fixing bugs it is crucial that the developers can 
   reproduce your problem. For this reason, entire debug logs, POMs or most 
   preferably little demo projects attached to the issue are very much appreciated.
   Of course, patches are welcome, too. Contributors can check out the project from 
-  our [source repository](./source-repository.html) and will find supplementary 
+  our [source repository](./scm.html) and will find supplementary 
   information in the
   [guide to helping with Maven](http://maven.apache.org/guides/development/guide-helping.html).
diff --git a/src/site/markdown/usage.md.vm b/src/site/markdown/usage.md.vm
new file mode 100644
index 0000000..809bc10
--- /dev/null
+++ b/src/site/markdown/usage.md.vm
@@ -0,0 +1,72 @@
+# Apache Maven Scripting Plugin
+<!--
+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.
+-->
+
+Usage
+-----
+
+This plugin contains generic code to evaluate any script that supports JSR223.
+It is a matter of adding the right dependency and configure the script to evaluate.
+
+<h3>Inline script</h3>
+
+Use the script-tag to specify your script. Make sure you also define the engineName.
+
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-scripting-plugin</artifactId>
+        <version>${project.version}</version>
+        <configuration>
+          <engineName>groovy</engineName>
+          <script>
+          <![CDATA[
+            // your groovy script
+          ]]>
+          </script>
+        </configuration>
+        <dependencies>
+          <!-- ScriptEngines -->
+          <dependency>
+            <groupId>org.codehaus.groovy</groupId>
+            <artifactId>groovy-jsr223</artifactId>
+            <version>2.4.7</version>
+          </dependency>
+        </dependencies>
+      </plugin>
+      
+<h3>Script from File</h3>
+
+Use the scriptFile-tag to refer to your script. The engine is based on the file-extension, but can be specified using the engineName-tag.
+
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-scripting-plugin</artifactId>
+        <version>${project.version}</version>
+        <configuration>
+          <scriptFile>path/to/script.groovy</scriptFile>
+        </configuration>
+        <dependencies>
+          <!-- ScriptEngines -->
+          <dependency>
+            <groupId>org.codehaus.groovy</groupId>
+            <artifactId>groovy-jsr223</artifactId>
+            <version>2.4.7</version>
+          </dependency>
+        </dependencies>
+      </plugin>
\ No newline at end of file