Fixed NAR-121

2 files changed, 34 insertions, 0 deletions

diff --git a/src/site/apt/compatibility.apt b/src/site/apt/compatibility.apt
new file mode 100644
index 0000000..ce25282
--- /dev/null
+++ b/src/site/apt/compatibility.apt
@@ -0,0 +1,32 @@
+	---
+Maven NAR Plugin
+	---
+	---
+Mark Donszelmann
+	---
+	
+Compatibility
+
+	For most of the NAR plugin we try to keep things backwards compatible. Versions 1.x were
+made for Maven 1 and therefore we are not compatible with those.
+
+	In the NAR Plugin 2.x series we had to introduce some backward incompatibilites and other changes.
+Below a (rather incomplete) list.
+
+* Version 2.1.x
+
+	* The internal layout of the nar files (.nar extension) is stable. No changes were made.
+
+	* The layout of the files under target and under the unpacked directory has changed. For more
+information see NarLayout21 (version 2.1.x and up) and NarLayout20 (version 2.0.x).
+
+	* The dependency in 2.0 used to be without a <type> specified. You now need to specify <type>nar</type>
+as this is more in line with the standard of maven. It also allows the NAR plugin to find dependencies 
+locally in a multi-module build. 
+
+	* The main artifact is a jar file, where the NAR plugin attaches a -noarch nar file and some 
+platform specific nar files. When installed and or deployed the main jar file is renamed to a nar file,
+hence the dependecy type change from jar to nar. 
+	
+	[]
+ 
diff --git a/src/site/site.xml b/src/site/site.xml
index 7e98cd5..918522f 100644
--- a/src/site/site.xml
+++ b/src/site/site.xml
@@ -44,6 +44,8 @@ under the License.
       <item name="FAQ" href="faq.html"/>
       <item name="AOL Properties" href="aol.html"/>
       <item name="Examples" href="examples.html"/>
+      <item name="Archetypes" href="archetypes.html"/>
+      <item name="Compatibility" href="compatibility.html"/>
     </menu>
    
     <menu name="Developer Info">