diff --git a/src/site/markdown/Category.md b/src/site/markdown/Category.md
new file mode 100644
index 0000000000..307a849b4c
--- /dev/null
+++ b/src/site/markdown/Category.md
@@ -0,0 +1,64 @@
+# Category
+
+A category.xml file can be used to define which content is placed into a p2 repository.
+It can also specify how to display the content in the p2 installation dialog.
+For Tycho to use it, it must to be placed into the root of an project with the packaging type 'eclipse-repository'.
+
+The 'category.xml' format was originally defined by the Eclipse PDE project.
+There are extensions to the format only supported by p2 and Tycho.
+
+The following listing is a simple category file listing only one feature and one plug-in.
+
+
+```
+
+
+
+
+
+
+
+```
+The following is an example, demonstrating a complex category definition.
+
+```
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ another.unit.id
+
+
+
+
+
+
+
+
+ Details on the category
+
+
+
+
+
+
+ id ~= /javax.*/
+
+
+```
\ No newline at end of file
diff --git a/src/site/site.xml b/src/site/site.xml
index d8c47bd0c6..144ab76d9f 100644
--- a/src/site/site.xml
+++ b/src/site/site.xml
@@ -8,6 +8,7 @@