From 57730bcfbe7749cb346abec32681e487aa05eb38 Mon Sep 17 00:00:00 2001
From: Roberto Rosario <roberto.rosario.gonzalez@gmail.com>
Date: Sat, 18 Feb 2012 04:12:38 -0400
Subject: [PATCH 1/5] Add versioning chapter and diagram

---
 docs/figure_src/versioning.svg | 211 +++++++++++++++++++++++++++++++++
 docs/topics/versioning.png     | Bin 0 -> 14432 bytes
 docs/topics/versioning.rst     |  25 ++++
 3 files changed, 236 insertions(+)
 create mode 100644 docs/figure_src/versioning.svg
 create mode 100644 docs/topics/versioning.png
 create mode 100644 docs/topics/versioning.rst

diff --git a/docs/figure_src/versioning.svg b/docs/figure_src/versioning.svg
new file mode 100644
index 0000000000..e5e64cf1f0
--- /dev/null
+++ b/docs/figure_src/versioning.svg
@@ -0,0 +1,211 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+   xmlns:dc="http://purl.org/dc/elements/1.1/"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:xlink="http://www.w3.org/1999/xlink"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   width="565.61804"
+   height="183.21297"
+   id="svg2"
+   version="1.1"
+   inkscape:version="0.48.2 r9819"
+   sodipodi:docname="New document 1">
+  <defs
+     id="defs4">
+    <marker
+       inkscape:stockid="Arrow1Lstart"
+       orient="auto"
+       refY="0"
+       refX="0"
+       id="Arrow1Lstart"
+       style="overflow:visible">
+      <path
+         id="path3860"
+         d="M 0,0 5,-5 -12.5,0 5,5 0,0 z"
+         style="fill-rule:evenodd;stroke:#000000;stroke-width:1pt;marker-start:none"
+         transform="matrix(0.8,0,0,0.8,10,0)"
+         inkscape:connector-curvature="0" />
+    </marker>
+    <marker
+       inkscape:stockid="Arrow1Lend"
+       orient="auto"
+       refY="0"
+       refX="0"
+       id="Arrow1Lend"
+       style="overflow:visible">
+      <path
+         id="path3863"
+         d="M 0,0 5,-5 -12.5,0 5,5 0,0 z"
+         style="fill-rule:evenodd;stroke:#000000;stroke-width:1pt;marker-start:none"
+         transform="matrix(-0.8,0,0,-0.8,-10,0)"
+         inkscape:connector-curvature="0" />
+    </marker>
+  </defs>
+  <sodipodi:namedview
+     id="base"
+     pagecolor="#ffffff"
+     bordercolor="#666666"
+     borderopacity="1.0"
+     inkscape:pageopacity="0.0"
+     inkscape:pageshadow="2"
+     inkscape:zoom="0.7"
+     inkscape:cx="266.59717"
+     inkscape:cy="67.029044"
+     inkscape:document-units="px"
+     inkscape:current-layer="layer1"
+     showgrid="false"
+     fit-margin-top="5"
+     fit-margin-left="5"
+     fit-margin-right="5"
+     fit-margin-bottom="5"
+     inkscape:window-width="1366"
+     inkscape:window-height="713"
+     inkscape:window-x="0"
+     inkscape:window-y="26"
+     inkscape:window-maximized="1" />
+  <metadata
+     id="metadata7">
+    <rdf:RDF>
+      <cc:Work
+         rdf:about="">
+        <dc:format>image/svg+xml</dc:format>
+        <dc:type
+           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+        <dc:title></dc:title>
+      </cc:Work>
+    </rdf:RDF>
+  </metadata>
+  <g
+     inkscape:label="Layer 1"
+     inkscape:groupmode="layer"
+     id="layer1"
+     transform="translate(-19.509401,-14.183039)">
+    <image
+       y="19.183039"
+       x="289.25891"
+       id="image2993"
+       xlink:href="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAABHNCSVQICAgIfAhkiAAAAoBJREFU
+WIXFl0FPE0EUx39vZrfSVJEeMGjkoBfQEzcP4F2DRgtyF+PZeJKDicZ488gX4AM01GKiXvgMejUh
+xsQLRIOiFAjW7vOwuwW23d02u6b/Zg6bnX3zm/+8mTcVVWWQco4/iIgz9uJtfb8ls82WAv3DWSMU
+8NZ+vLx9D/gb1689cVVtN+DM8LN3mlXrG9+1tFSrATYJQFVPOgAM+TOHN5+2EN+V1FmrKh5wZ3IM
+ebSKLs9TXZypzGutevBqbgFoxX1rIs8S2m4NuEZwemh+vzCiYWO7wc2JUaqL05Xik1o1yYkoQFuu
+MTiOwbWS2hzH4BrTnsLIUIGPm7+YnTyXChELYEX6bqHKRYdyscCHAKL2YKZSWuoO0QEQ5r21gjX9
+NT+A4hjDxeFTjA8X2dje48bEKGsPr1fKT+t1IjsvmoRHL0QQEdJT0IcODbg/fRl5/Jr2hwp4Hro8
+T9O4t4AisJsKYE3vAACewNedfVYWplhZmOrap+UpwFBvAH04AGBE2Gocsrl7CHLMgGBNr42Xw+U9
+ETLBAYMIPQOEsaNnZ9pRH58DVoKQ2aQpERKXIB+AZMU7YHw78wBIipHowGAAAs9s7BmZkSYVIJDt
+oQrmodQcyEOZcmBgAI41/iGSQxYmXWpiAQrWDGgXBL3XP3/D5JSInipzVy90JekACPtYI+2ClEWq
+SqtbFYoDOAIJf1mVHCMWQNGglGZ3QBP2UxcACT6EVmot6xXgZOxEADcow3evnM84dKdcKxykAZQc
+Gmefvz/d9PToOpNV4v93KDk0fkdfHb+xiMgIcAkok/0IiEqBn8AXYCccNwrgAiWgkPPgof4Ae0Az
+DuA/jdupcNx/sUsQuWjMJzEAAAAASUVORK5CYII=
+"
+       height="32"
+       width="32" />
+    <text
+       xml:space="preserve"
+       style="font-size:13px;font-style:normal;font-weight:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:Sans"
+       x="233.34525"
+       y="69.483757"
+       id="text2996"
+       sodipodi:linespacing="125%"><tspan
+         sodipodi:role="line"
+         id="tspan2998"
+         x="233.34525"
+         y="69.483757">Original version: 1.0.0</tspan></text>
+    <image
+       y="138.33658"
+       x="86.025414"
+       id="image3008"
+       xlink:href="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAABHNCSVQICAgIfAhkiAAABNlJREFU
+WIWtl2tsVEUUgL953Lu7bVkoDwvEJkrCKwZDgtgm1RifQEgpUJFfEIgm4B9D9IcWFGIMmICJyA8w
+RoNG/GEIRSjUkJIYoIpAgYSEAmlQ6AMo0AK27Jbt7h1/3LuPsu3uLXA2k3szO3PON2fOPWdGGGMQ
+Qujxnx/8LZIQ8/sTBjAMV5QU2Dj7ur+ofBuI+55ojAEYEV5fbx5XDrfcMoUf19YCyq997T2D7sph
+/8UbCEAI4QveAaqmjUd8sAezrZrdK19aVG1qf41uXrwUSOTTIb2nSLpdSbCkQPto7rikJklLVy/z
+po5j98qK6tDaA22A5RcgJZaUaC2xlMjbtJZYUqaWMCpoc/b6PeZPe4rdy2ZPCK2tu5IPIgtACTHs
+lpTikKY4ZHPGg6hdXjaxcF1uiBRAMu6VEig5vOYqMGgpeTocoDQcoqXrPnOnjmPfivKJozfUdwwF
+obM6hEAIQf4QdKGTDlhRMQmxZi+piQZwHMy2amKOGQcUAnfzAijpHwDAEdB6N8LOJTPZuWTmoGMS
+jgGwB/svG2AYHgCQQnCj9wHXex6AyHCAt6dlpcU509ogHpCIDEX+RGQZMcZfNs2OASU8lY8nxqeG
+QbfgyQD4k2wPSNedTwIgrWNobYN64FEBBNKrIWKAXUPAB4DnM5WVG/0YFgip0NJCSenWh8xAFmN8
+AHiifFTBh40raWFrzfn2I+w9VcNfl46TTJCWgudCsxDLmHL6Z27xUHgMGQO+jSuLkKXY3rCSI80/
+Ujl7MUsqviYUKATgQSzChfaTNIw8f2zs9L7vD61lNRllesgY8CNKaoKWYnPdAi5cq2P90m/o6DlJ
+w+V13OyNAFBSVMiM8Yv4cOFWttd/+t6cjbfFoXWsSkJk7bhW0q33KnezlCJgaZrbG2n6p441C77k
+z9YtnGz7hTvRCDuqDDuqDN3R+/zdtoujVzayam4No0YWvfvKR1TghUgWgK0ktlYEVJ6mNQUW7DlR
+w6Lydzh34ye6o+1omS5Q4L5rCV2RNs5e+4F5s5YSGM0mvOqY3gJv0uHLN5E+AlEKTdAupvFSI6+9
+8D5Hr14kbiDhQMxJj4s5oBz362rraebVZ99AaCqAEBBLASRNKilSBSk3gMCSGi3hZl8TDrDlrezo
+2VGZ7vvksKAzeippyx7ogRRI8pdbhPehS6A31po+G+YQJd2xmWkqC8BgvFKaG8HBpE7Fd6OdBG34
+7A9BvwN9cdg6x135mkOCoAZLQsiGe30dA2Ikg9vtNQYSxvhoDv2JGNNKX+bWbQhYUBCAogAUZBw9
+CmyvL+CO6eqG/ghn8BJSygOWV4YXTp+Q35cZUl6ynWXfzaB0IigL4gkGZP6ABZYGrUAYuPwvdJxm
+KxAbAFCoTM/IDb+P6HdM+jiTUwRCKLQKMzlYRdPpfZTNBmWDlLDpuEh5wNKAA8eb4E47+5vrOAZE
+AYR3NxwFTAq/vrzCxGPDuxgaaRJxaV4s2zV3zDNUTpkMJSWgvaXF49DZCZdaoKuNg0e+oga4CvQA
+JglgASNwT66PUA/RQHjKm5SXlrHaDvN8Kp8LiP3HudYTfNvSQCPQAdzDS8VJAG8o8hEAjDcnBBQD
+Y4Ei0hfUBNAL3Aa6gftkFKNMgMcVgZteQ7hJJvOGEMPd834eKsf/A5D84oCyPZs+AAAAAElFTkSu
+QmCC
+"
+       height="32"
+       width="32" />
+    <text
+       xml:space="preserve"
+       style="font-size:13px;font-style:normal;font-weight:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:Sans"
+       x="23.233522"
+       y="189.69191"
+       id="text3011"
+       sodipodi:linespacing="125%"><tspan
+         sodipodi:role="line"
+         id="tspan3013"
+         x="23.233522"
+         y="189.69191">New major version: 2.0.0</tspan></text>
+    <image
+       y="138.41853"
+       x="291.98331"
+       id="image3008-2"
+       xlink:href="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAABHNCSVQICAgIfAhkiAAABNlJREFU WIWtl2tsVEUUgL953Lu7bVkoDwvEJkrCKwZDgtgm1RifQEgpUJFfEIgm4B9D9IcWFGIMmICJyA8w RoNG/GEIRSjUkJIYoIpAgYSEAmlQ6AMo0AK27Jbt7h1/3LuPsu3uLXA2k3szO3PON2fOPWdGGGMQ Qujxnx/8LZIQ8/sTBjAMV5QU2Dj7ur+ofBuI+55ojAEYEV5fbx5XDrfcMoUf19YCyq997T2D7sph /8UbCEAI4QveAaqmjUd8sAezrZrdK19aVG1qf41uXrwUSOTTIb2nSLpdSbCkQPto7rikJklLVy/z po5j98qK6tDaA22A5RcgJZaUaC2xlMjbtJZYUqaWMCpoc/b6PeZPe4rdy2ZPCK2tu5IPIgtACTHs lpTikKY4ZHPGg6hdXjaxcF1uiBRAMu6VEig5vOYqMGgpeTocoDQcoqXrPnOnjmPfivKJozfUdwwF obM6hEAIQf4QdKGTDlhRMQmxZi+piQZwHMy2amKOGQcUAnfzAijpHwDAEdB6N8LOJTPZuWTmoGMS jgGwB/svG2AYHgCQQnCj9wHXex6AyHCAt6dlpcU509ogHpCIDEX+RGQZMcZfNs2OASU8lY8nxqeG QbfgyQD4k2wPSNedTwIgrWNobYN64FEBBNKrIWKAXUPAB4DnM5WVG/0YFgip0NJCSenWh8xAFmN8 AHiifFTBh40raWFrzfn2I+w9VcNfl46TTJCWgudCsxDLmHL6Z27xUHgMGQO+jSuLkKXY3rCSI80/ Ujl7MUsqviYUKATgQSzChfaTNIw8f2zs9L7vD61lNRllesgY8CNKaoKWYnPdAi5cq2P90m/o6DlJ w+V13OyNAFBSVMiM8Yv4cOFWttd/+t6cjbfFoXWsSkJk7bhW0q33KnezlCJgaZrbG2n6p441C77k z9YtnGz7hTvRCDuqDDuqDN3R+/zdtoujVzayam4No0YWvfvKR1TghUgWgK0ktlYEVJ6mNQUW7DlR w6Lydzh34ye6o+1omS5Q4L5rCV2RNs5e+4F5s5YSGM0mvOqY3gJv0uHLN5E+AlEKTdAupvFSI6+9 8D5Hr14kbiDhQMxJj4s5oBz362rraebVZ99AaCqAEBBLASRNKilSBSk3gMCSGi3hZl8TDrDlrezo 2VGZ7vvksKAzeippyx7ogRRI8pdbhPehS6A31po+G+YQJd2xmWkqC8BgvFKaG8HBpE7Fd6OdBG34 7A9BvwN9cdg6x135mkOCoAZLQsiGe30dA2Ikg9vtNQYSxvhoDv2JGNNKX+bWbQhYUBCAogAUZBw9 CmyvL+CO6eqG/ghn8BJSygOWV4YXTp+Q35cZUl6ynWXfzaB0IigL4gkGZP6ABZYGrUAYuPwvdJxm KxAbAFCoTM/IDb+P6HdM+jiTUwRCKLQKMzlYRdPpfZTNBmWDlLDpuEh5wNKAA8eb4E47+5vrOAZE AYR3NxwFTAq/vrzCxGPDuxgaaRJxaV4s2zV3zDNUTpkMJSWgvaXF49DZCZdaoKuNg0e+oga4CvQA JglgASNwT66PUA/RQHjKm5SXlrHaDvN8Kp8LiP3HudYTfNvSQCPQAdzDS8VJAG8o8hEAjDcnBBQD Y4Ei0hfUBNAL3Aa6gftkFKNMgMcVgZteQ7hJJvOGEMPd834eKsf/A5D84oCyPZs+AAAAAElFTkSu QmCC "
+       height="32"
+       width="32" />
+    <text
+       xml:space="preserve"
+       style="font-size:13px;font-style:normal;font-weight:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:Sans"
+       x="216.05945"
+       y="189.77386"
+       id="text3011-9"
+       sodipodi:linespacing="125%"><tspan
+         sodipodi:role="line"
+         id="tspan3013-6"
+         x="216.05945"
+         y="189.77386">New minor version: 1.1.0</tspan></text>
+    <image
+       y="137.65823"
+       x="494.88431"
+       id="image3008-2-2"
+       xlink:href="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAABHNCSVQICAgIfAhkiAAABNlJREFU WIWtl2tsVEUUgL953Lu7bVkoDwvEJkrCKwZDgtgm1RifQEgpUJFfEIgm4B9D9IcWFGIMmICJyA8w RoNG/GEIRSjUkJIYoIpAgYSEAmlQ6AMo0AK27Jbt7h1/3LuPsu3uLXA2k3szO3PON2fOPWdGGGMQ Qujxnx/8LZIQ8/sTBjAMV5QU2Dj7ur+ofBuI+55ojAEYEV5fbx5XDrfcMoUf19YCyq997T2D7sph /8UbCEAI4QveAaqmjUd8sAezrZrdK19aVG1qf41uXrwUSOTTIb2nSLpdSbCkQPto7rikJklLVy/z po5j98qK6tDaA22A5RcgJZaUaC2xlMjbtJZYUqaWMCpoc/b6PeZPe4rdy2ZPCK2tu5IPIgtACTHs lpTikKY4ZHPGg6hdXjaxcF1uiBRAMu6VEig5vOYqMGgpeTocoDQcoqXrPnOnjmPfivKJozfUdwwF obM6hEAIQf4QdKGTDlhRMQmxZi+piQZwHMy2amKOGQcUAnfzAijpHwDAEdB6N8LOJTPZuWTmoGMS jgGwB/svG2AYHgCQQnCj9wHXex6AyHCAt6dlpcU509ogHpCIDEX+RGQZMcZfNs2OASU8lY8nxqeG QbfgyQD4k2wPSNedTwIgrWNobYN64FEBBNKrIWKAXUPAB4DnM5WVG/0YFgip0NJCSenWh8xAFmN8 AHiifFTBh40raWFrzfn2I+w9VcNfl46TTJCWgudCsxDLmHL6Z27xUHgMGQO+jSuLkKXY3rCSI80/ Ujl7MUsqviYUKATgQSzChfaTNIw8f2zs9L7vD61lNRllesgY8CNKaoKWYnPdAi5cq2P90m/o6DlJ w+V13OyNAFBSVMiM8Yv4cOFWttd/+t6cjbfFoXWsSkJk7bhW0q33KnezlCJgaZrbG2n6p441C77k z9YtnGz7hTvRCDuqDDuqDN3R+/zdtoujVzayam4No0YWvfvKR1TghUgWgK0ktlYEVJ6mNQUW7DlR w6Lydzh34ye6o+1omS5Q4L5rCV2RNs5e+4F5s5YSGM0mvOqY3gJv0uHLN5E+AlEKTdAupvFSI6+9 8D5Hr14kbiDhQMxJj4s5oBz362rraebVZ99AaCqAEBBLASRNKilSBSk3gMCSGi3hZl8TDrDlrezo 2VGZ7vvksKAzeippyx7ogRRI8pdbhPehS6A31po+G+YQJd2xmWkqC8BgvFKaG8HBpE7Fd6OdBG34 7A9BvwN9cdg6x135mkOCoAZLQsiGe30dA2Ikg9vtNQYSxvhoDv2JGNNKX+bWbQhYUBCAogAUZBw9 CmyvL+CO6eqG/ghn8BJSygOWV4YXTp+Q35cZUl6ynWXfzaB0IigL4gkGZP6ABZYGrUAYuPwvdJxm KxAbAFCoTM/IDb+P6HdM+jiTUwRCKLQKMzlYRdPpfZTNBmWDlLDpuEh5wNKAA8eb4E47+5vrOAZE AYR3NxwFTAq/vrzCxGPDuxgaaRJxaV4s2zV3zDNUTpkMJSWgvaXF49DZCZdaoKuNg0e+oga4CvQA JglgASNwT66PUA/RQHjKm5SXlrHaDvN8Kp8LiP3HudYTfNvSQCPQAdzDS8VJAG8o8hEAjDcnBBQD Y4Ei0hfUBNAL3Aa6gftkFKNMgMcVgZteQ7hJJvOGEMPd834eKsf/A5D84oCyPZs+AAAAAElFTkSu QmCC "
+       height="32"
+       width="32" />
+    <text
+       xml:space="preserve"
+       style="font-size:13px;font-style:normal;font-weight:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:Sans"
+       x="418.96045"
+       y="189.01357"
+       id="text3011-9-6"
+       sodipodi:linespacing="125%"><tspan
+         sodipodi:role="line"
+         id="tspan3013-6-4"
+         x="418.96045"
+         y="189.01357">New micro version: 1.0.1</tspan></text>
+    <path
+       style="fill:none;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker-start:url(#Arrow1Lstart);marker-end:url(#Arrow1Lend)"
+       d="m 110.10663,126.0523 c 0,-109.138839 196.30631,6.06092 197.09645,-42.415649 0.79014,48.498089 197.09644,-64.75136 197.09644,42.437169"
+       id="path3067"
+       inkscape:connector-curvature="0"
+       sodipodi:nodetypes="ccc" />
+    <path
+       style="fill:none;stroke:#000000;stroke-width:1;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-opacity:1;stroke-dasharray:none;marker-end:url(#Arrow1Lend)"
+       d="m 307.21636,84.18173 0,46.12327"
+       id="path3087"
+       inkscape:connector-curvature="0"
+       sodipodi:nodetypes="cc" />
+  </g>
+</svg>
diff --git a/docs/topics/versioning.png b/docs/topics/versioning.png
new file mode 100644
index 0000000000000000000000000000000000000000..6ec2f24d866d076175fb71358001441a72c8f185
GIT binary patch
literal 14432
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
W8n{^y2%H8af!#5@{pF@z<o^MkCfG*+

literal 0
HcmV?d00001

diff --git a/docs/topics/versioning.rst b/docs/topics/versioning.rst
new file mode 100644
index 0000000000..5aa6dedee9
--- /dev/null
+++ b/docs/topics/versioning.rst
@@ -0,0 +1,25 @@
+===================
+Document versioning
+===================
+
+**Mayan EDMS** has the ability to store different versions of the same 
+document.  Users are provided with a very comprehensive but easy to use 
+version numbering system that allows specifying a major, minor or micro 
+version number increase.
+
+.. image:: versioning.png
+ :alt: versioning diagram
+
+A comment field is also provided to allow users 
+to summarize the new verdion changes in comparison with the previous 
+one.  If a new version was uploded by mistake or such new version is no 
+longer necessary **Mayan EDMS** provides the option to revert to a previous 
+version of the document.
+
+To upload a new document version, select an existing document, click on the 
+version tab of the document, and click on the 'upload new version' on the 
+side bar.  A new view very similar to the new document upload view will 
+appear show the same interactive document sources that have been defined, 
+but with new options to specify the new version number and an optional  
+comment. 
+

From 8e46f2818e885c23d37be0adc295d772e183c4a2 Mon Sep 17 00:00:00 2001
From: Roberto Rosario <roberto.rosario.gonzalez@gmail.com>
Date: Sat, 18 Feb 2012 04:12:59 -0400
Subject: [PATCH 2/5] Moved bulk document and user import to a separate chapter

---
 docs/releases/0.12.rst         | 44 ++++++++++---------------------
 docs/topics/initial_import.rst | 48 ++++++++++++++++++++++++++++++++++
 2 files changed, 62 insertions(+), 30 deletions(-)
 create mode 100644 docs/topics/initial_import.rst

diff --git a/docs/releases/0.12.rst b/docs/releases/0.12.rst
index 1f3563a4b2..68dba8a8ea 100644
--- a/docs/releases/0.12.rst
+++ b/docs/releases/0.12.rst
@@ -46,6 +46,10 @@ ACL support
 * Object level access control is now in place for documents, folders,
   tags and smart links.  What this means is that administrators can now
   grant permissions to users, groups or roles on for specific objects.
+  A more in-depth explanation of how this new ACL system can be found in
+  the :doc:`3 tier access control <../topics/permissions>` section of the
+  permissions chapter.
+  
 * Default class ACL support.  Administrators can setup the access control
   lists that new documents, folders and tags will automatically inheric
   when created.  Aside from asigning permission to users, groups and roles
@@ -83,52 +87,32 @@ the download of several documents in a single compressed file.
 
 Customizable GPG home directory
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-Addition of the SIGNATURES_GPG_HOME configuration option to let 
+Addition of the :setting:`SIGNATURES_GPG_HOME` configuration option to let 
 administrators set **Mayan EDMS**'s GPG instance home directory, used to
 store keyrings and other GPG configuration files.
 
 Out of process bulk uploading
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 A management command has been added to help upload a large number of documents
-from a compressed file.  The command line options for this feature are as
-follow::
+from a compressed file.  For information about this new feature check the 
+:doc:`Initial data loading <../topics/initial_import>` chapter.
 
-  $ ./manage.py bulk_upload --noinput --metadata '{"project": "bulk"}' --document_type "Accounting documents" compressed.zip 
-
-**Optional arguments**
-
-* The ``--noinput`` argument skips confirmation and starts the upload immediately.
-* The ``--metadata`` argument allows specifing what metadata will be assigned
-  to the documents when uploaded.
-* And the ``--document_type`` applies a previously defined 
-  document type to the uploaded documents.
   
 Out of process user import
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 A management command has been added to import a large number users
-from a CSV file.  The command line options for this feature are as
-follow::
+from a CSV file.  More information about this new feature can also be found 
+in the :doc:`Initial data loading <../topics/initial_import>` chapter.
 
-  $ ./manage.py import_users --noinput --password=welcome123 --skip-repeated user_list.csv 
-
-The CSV field order must be: username, first name, last name and email, any other 
-column after those is ignored.
-
-**Optional arguments**
-
-* The ``--noinput`` argument skips confirmation and starts the import immediately.
-* The ``--password`` argument allows specifing what default password will be assigned
-  to all the new users that are imported.
-* The ``--skip-repeated`` tells the importedr to not stop when finding
-  that a user already exists in the database.
 
 Refactored document indexing
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-The document indexing functionality has been improved and moved from experimental
+:doc:`The document indexing  <../topics/indexes>` functionality has been
+improved and moved from experimental
 stage to beta stage.  Index configuration menus are now available on the
-``Setup`` menu and allows administrators to create a skeleton tree that will
+``Setup`` menu and allows administrators to create skeleton trees that will
 be populated with document links depending on their metadata and properties.
-This populated tree can also be mirrored on the physical filesystem and shared
+These populated trees can also be mirrored on the physical filesystem and shared
 using Samba or another filesharing server giving users a structured view
 of the documents contained within **Mayan EDMS** from the ``Indexes`` tab
 or from a mirrored index shared via the network.  A new configuration option
@@ -147,7 +131,7 @@ the need of the **Mayan EDMS** user base.
 
 Staging file previews
 ~~~~~~~~~~~~~~~~~~~~~
-The staging file previews now show the filename as the title for easier
+The staging file previews now show the filename for easier
 identification and speedier upload selection.  The staging files previews
 are now treated as a gallery which means that users can preview an entire
 page of staging files without having to click and close each one
diff --git a/docs/topics/initial_import.rst b/docs/topics/initial_import.rst
new file mode 100644
index 0000000000..72859f49bf
--- /dev/null
+++ b/docs/topics/initial_import.rst
@@ -0,0 +1,48 @@
+====================
+Initial data loading
+====================
+
+Bulk document import
+--------------------
+
+**Mayan EDMS** has the ability to individually upload the contents of compressed 
+files, however by nature of being a web based application it is bounded by the 
+limitations of the HTTP protocol, this imposes a limit on the file size and 
+the amount of time **Mayan EDMS** may keep a connection open while it processes 
+compressed files.  When the desired amount of documents is bigger than what 
+these limitations allow, **Mayan EDMS** provides a command line tool for out of 
+process document importation.
+
+The command line options for this feature are as follows::
+
+  $ ./manage.py bulk_upload --noinput --metadata '{"project": "bulk"}' --document_type "Accounting documents" compressed.zip 
+
+**Optional arguments**
+
+* The ``--noinput`` argument skips confirmation and starts the upload immediately.
+* The ``--metadata`` argument allows specifing what metadata will be assigned
+  to the documents when uploaded.
+* And the ``--document_type`` applies a previously defined 
+  document type to the uploaded documents.
+
+
+Bulk user import
+----------------
+
+As well as providing bulk document import functionality **Mayan EDMS** also
+includes a management command to import a large number users
+from a CSV file.  The command line options for this feature are as
+follow::
+
+  $ ./manage.py import_users --noinput --password=welcome123 --skip-repeated user_list.csv 
+
+The CSV field order must be: username, first name, last name and email, any other 
+column after those is ignored.
+
+**Optional arguments**
+
+* The ``--noinput`` argument skips confirmation and starts the import immediately.
+* The ``--password`` argument allows specifing what default password will be assigned
+  to all the new users that are imported.
+* The ``--skip-repeated`` tells the importedr to not stop when finding
+  that a user already exists in the database.

From 03cdea8920b7b3cb1b8079e4b0e3039cf97ea279 Mon Sep 17 00:00:00 2001
From: Roberto Rosario <roberto.rosario.gonzalez@gmail.com>
Date: Sat, 18 Feb 2012 04:13:32 -0400
Subject: [PATCH 3/5] Add document signatures chapter

---
 docs/topics/index.rst      | 11 +++++++----
 docs/topics/signatures.rst | 24 ++++++++++++++++++++++++
 2 files changed, 31 insertions(+), 4 deletions(-)
 create mode 100644 docs/topics/signatures.rst

diff --git a/docs/topics/index.rst b/docs/topics/index.rst
index 2d297d1745..a97ff7d101 100644
--- a/docs/topics/index.rst
+++ b/docs/topics/index.rst
@@ -6,10 +6,13 @@ Introductions to all the key parts of Mayan EDMS you'll need to know:
 .. toctree::
    :maxdepth: 1
 
+   file_storage
+   initial_import
+   permissions
+   transformations
+   document_visualization
+   versioning
+   signatures
    indexes
    smart_links
-   permissions
-   document_visualization
    ocr
-   file_storage
-   transformations
diff --git a/docs/topics/signatures.rst b/docs/topics/signatures.rst
new file mode 100644
index 0000000000..f2cad89fc2
--- /dev/null
+++ b/docs/topics/signatures.rst
@@ -0,0 +1,24 @@
+===================
+Document signatures
+===================
+
+**Mayan EDMS** supports two types of document signatures, these are embedded and 
+detached signatures.  When a document with an embedded signature is 
+uploaded, this signature is readily detected as part of the document 
+inspection step.  If the public key corresponding to the signee of the 
+document is not found, **Mayan EDMS** will try to obtain it from the list of 
+keyserver specified in the config option :setting:`SIGNATURES_KEYSERVERS`.
+Failing that, **Mayan EDMS** will indicate that the document is signed
+but that it has no way to verify such signature.
+Existing non signed documents can be signed in one of two way:  
+by downloading the document, signing it, and uploading the signed document 
+as a new version of the existing one using **Mayan EDMS** :doc:`versioning support <versioning>`
+or by creating a detached signature for the non signed document and uploading 
+such detached signature file using the option likewise named menu option.
+
+Maintenance of the public keyring can be done using the ``Key management`` 
+functionality in the ``Setup menu`` 
+
+From this menu, key servers can be queried 
+and the results imported.  Public keys no longer needed can also be deleted 
+from this menu.

From d51a5590f89fcbbb4305f753ccbcdf3c0ab1ea6c Mon Sep 17 00:00:00 2001
From: Roberto Rosario <roberto.rosario.gonzalez@gmail.com>
Date: Sat, 18 Feb 2012 04:13:49 -0400
Subject: [PATCH 4/5] Updated documentation index

---
 docs/index.rst          | 13 ++++++++-----
 docs/releases/index.rst |  9 +++------
 2 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/docs/index.rst b/docs/index.rst
index a28c4f98f6..b13a2291a4 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -38,13 +38,16 @@ First steps
 Understanding Mayan EDMS
 ========================
 
+  :doc:`File storage <topics/file_storage>` |
+  :doc:`Initial data loading <topics/initial_import>` |
+  :doc:`Permission system <topics/permissions>` |
+  :doc:`Transformations <topics/transformations>` |
+  :doc:`Document visualization <topics/document_visualization>` |
+  :doc:`Document versioning <topics/versioning>` |
+  :doc:`Document signatures <topics/signatures>` |
   :doc:`Indexes <topics/indexes>` |
   :doc:`Smart links <topics/smart_links>` |
-  :doc:`Permission system <topics/permissions>` |
-  :doc:`Document visualization <topics/document_visualization>` |
-  :doc:`OCR <topics/ocr>` |
-  :doc:`File storage <topics/file_storage>` |
-  :doc:`Transformations <topics/transformations>`
+  :doc:`OCR <topics/ocr>`
 
 
 Between versions
diff --git a/docs/releases/index.rst b/docs/releases/index.rst
index bd3fc2ddd6..3bbee2aa57 100644
--- a/docs/releases/index.rst
+++ b/docs/releases/index.rst
@@ -11,18 +11,15 @@ all the backwards-incompatible changes and deprecated features for
 each 'final' release from the one after your current **Mayan EDMS** version,
 up to and including the new version.
 
-Final releases
-==============
-
-0.12 release
-------------
+Latest version (0.12)
+---------------------
 .. toctree::
    :maxdepth: 1
 
    0.12
 
 Historic changelogs
-===================
+-------------------
 .. toctree::
    :maxdepth: 1
 

From a510cfe6d0db946da9b81d0a188e8252a6e27bb4 Mon Sep 17 00:00:00 2001
From: Roberto Rosario <roberto.rosario.gonzalez@gmail.com>
Date: Sat, 18 Feb 2012 04:19:56 -0400
Subject: [PATCH 5/5] Link features to the actual chapter where they are
 discussed

---
 docs/intro/features.rst | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/docs/intro/features.rst b/docs/intro/features.rst
index 43e9bfa267..71d19c1dd9 100644
--- a/docs/intro/features.rst
+++ b/docs/intro/features.rst
@@ -2,11 +2,11 @@
 Features
 ========
 
-* Document versioning.
+* :doc:`Document versioning <../topics/versioning>`.
 
   * Store many versions of the same document, download or revert to a previous version.
 
-* Electronic signature verification.
+* :doc:`Electronic signature verification <../topics/signatures>`.
 
   * Check the authenticity of documents by verifying their embedded
     cryptographic signatures or upload detached signatures for document
@@ -56,11 +56,11 @@ Features
     
   * Automatic linking of documents based on metadata values or document properties.
 
-* Roles support.
+* :doc:`Roles support <../topics/permissions>`.
 
   * Users can created an unlimited amount of different roles and are not restricted to the traditional admin, operator, guest paradigm.
 
-* Fine grained permissions system.
+* :doc:`Fine grained permissions system <../topics/permissions>`.
 
   * There is a permission for every atomic operation performed by users.
 
@@ -68,7 +68,7 @@ Features
 
   * Multiple page PDFs and TIFFs files supported.
 
-* Distributed OCR processing.
+* :doc:`Distributed OCR processing <../topics/ocr>`.
 
   * The task of transcribing text from documents via OCR can be distributed among several physical or virtual computers to decrease load and increase availability.
 
@@ -76,13 +76,13 @@ Features
 
   * **Mayan EDMS** is written using the Django_ framework which natively support Unicode, this coupled with the use of text templates allows **Mayan EDMS** to be translated to practically any language spoken in the world, by default four translations are provided: English, Spanish, Portuguese and Russian.
 
-* Multilingual OCR support.
+* :doc:`Multilingual OCR support <../topics/ocr>`.
 
   * As supported by the OCR engine tesseract.
 
 * Duplicated document search.
 
-* Plugable storage backends (File based and GridFS included).
+* :doc:`Plugable storage backends <../topics/file_storage>` (File based and GridFS included).
     
   * Very easy to use 3rd party plugins such as the ones available for Amazon EC2.