diff --git a/faq/maven.xml b/faq/maven.xml
new file mode 100644
index 00000000..e605ef58
--- /dev/null
+++ b/faq/maven.xml
@@ -0,0 +1,10 @@
+<project default="plugin:install">
+
+  <postGoal name="xdoc:copy-resources">
+    <copy todir="${basedir}/target/docs">
+      <fileset dir="${basedir}/xdocs">
+        <include name="**/*.fml"/>
+      </fileset>
+    </copy>
+  </postGoal>
+</project>
diff --git a/faq/xdocs/faq.fml b/faq/xdocs/faq.fml
new file mode 100644
index 00000000..786f6a44
--- /dev/null
+++ b/faq/xdocs/faq.fml
@@ -0,0 +1,42 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<faqs title="Frequently Asked Questions">
+
+  <part id="general">
+    <title>General</title>
+   
+    <faq id="whats-foo">
+      <question>
+        What is Foo?
+      </question>
+      <answer>
+        <p>some markup goes here</p>
+        
+        <source>some source code</source>
+        
+        <p>some markup goes here</p>
+      </answer>
+    </faq>
+
+    <faq id="whats-bar">
+      <question>
+        What is Bar?
+      </question>
+      <answer>
+        <p>some markup goes here</p>
+      </answer>
+    </faq>
+  </part>
+  
+  <part id="install">
+    <title>Installation</title>
+   
+    <faq id="how-install">
+      <question>
+        How do I install Foo?
+      </question>
+      <answer>
+        <p>some markup goes here</p>
+      </answer>
+    </faq>
+  </part>  
+</faqs>
\ No newline at end of file
diff --git a/faq/xdocs/index.xml b/faq/xdocs/index.xml
index 1c7f2ea8..58c906b4 100644
--- a/faq/xdocs/index.xml
+++ b/faq/xdocs/index.xml
@@ -10,6 +10,13 @@
     <section name="Maven FAQ Plug-in">
       <p>
 				This plugin generates xdoc documentation from an XML FAQ document.
+				This automates the creation of an index of questions with hypertext
+				links to the full question and answers.
+      </p>
+      <p>
+        The plugin uses by default a file called <code>xdocs/faq.fml</code>
+        to generate the FAQ entry. There is an example of the XML format 
+        <a href="faq.fml">here</a>.
       </p>
       <p>
         The properties that allow you to customize the execution