From cd05f7fde0c0c7e39d57db72743166b20a127bfb Mon Sep 17 00:00:00 2001
From: Roberto Rosario <roberto.rosario.gonzalez@gmail.com>
Date: Wed, 3 Oct 2012 01:31:25 -0400
Subject: [PATCH] Add initial release notes for upcoming 0.12.3

---
 docs/releases/0.12.3.rst | 92 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 92 insertions(+)
 create mode 100644 docs/releases/0.12.3.rst

diff --git a/docs/releases/0.12.3.rst b/docs/releases/0.12.3.rst
new file mode 100644
index 0000000000..f2cd407202
--- /dev/null
+++ b/docs/releases/0.12.3.rst
@@ -0,0 +1,92 @@
+================================
+Mayan EDMS v0.12.3 release notes
+================================
+
+*October 2012*
+
+This is the third maintenance release of the 0.12 series.
+
+Overview
+========
+
+
+Once again the focus for this release in the 0.12 series is including
+bug fixes and minor feature.  `issue #31`_ has been implemented adding bulk
+document tagging and untagging.
+
+
+What's new in Mayan EDMS v0.12.3
+================================
+
+Django 1.3.3
+~~~~~~~~~~~~
+
+Per document type indexing
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+**Mayan EDMS** creates a administrator user during the
+database creation phase to reduce the amount of steps required for a
+functional install.  The creation of this account is controlled by the configuration
+option :setting:`COMMON_AUTO_CREATE_ADMIN`, the username of the account is
+specified with the configuration option :setting:`COMMON_AUTO_ADMIN_USERNAME`
+and the password of this account by the option :setting:`COMMON_AUTO_ADMIN_PASSWORD`.
+Previously the :setting:`COMMON_AUTO_ADMIN_PASSWORD` defaulted to 'admin' which
+created an administrator account of username 'admin' with a password of
+'admin'.  The new default is to randomize an initial password and show this password
+at the login screen until the administrator password is changed.
+
+.. image:: mayan_first_login.png
+ :alt: First login dialog
+
+Document check outs
+~~~~~~~~~~~~~~~~~~~
+As per the feature request filed under `issue #26`_, a new document
+check out and check in functionality has been added.  Users can now
+check out a document and lock new version of it from being uploaded to avoid
+editing conflicts.  Document check outs have an expiration period after which
+**Mayan EDMS** will automatically check them back in to avoid a permanent
+document lockout.  Only the user who has checked out a document can upload
+new versions of it or check the document back in before the expiration period,
+unless being granted the ``Allow overriding check out restrictions`` or 
+``Forcefully check in documents`` permission respectively.
+
+Installation environment app improvements
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Diagnosting remote installations of web based applications without access to the
+command line can be a bit hard, to alleviate this situation a new installation
+environment details app has been added.  The purpose of this app is to provide
+support staff information about the physical environment where **Mayan EDMS** has
+been installed.  To avoid possible security compromises only administrators
+can access this app.
+
+Translation updates
+~~~~~~~~~~~~~~~~~~~
+
+
+Upgrading from a previous version
+=================================
+
+Start off by adding the new requirements::
+
+    $ pip install -r requirements/production.txt
+
+Migrate existing database schema with::
+
+    $ ./manage.py migrate document_indexing
+
+Add new static media::
+
+    $ ./manage.py collectstatic --noinput
+
+The upgrade procedure is now complete.
+
+
+Backward incompatible changes
+=============================
+* None
+
+Bugs fixed
+==========
+* `issue #31`_ "Bulk add tags Feature request"
+
+
+.. _issue #31: https://github.com/rosarior/mayan/issues/31