Configuration and documentation for translation locking (issue #60)

docs/admin.rst

@@ -213,6 +213,21 @@ fulfilled:
 * translation for a language is completed
 * explicit commit is requested
 
+.. _locking:
+
+Translation locking
+-------------------
+
+To improve collaboration, it is good to prevent duplicate effort on
+translation. To achieve this, translation can be locked for single translator.
+This can be either done manually on translation page or is done automatically
+when somebody starts to work on translation. The automatic locking needs to be
+enabled using :setting:`AUTO_LOCK`.
+
+The lock is valid for :setting:`LOCK_TIME` seconds and is automatically
+extended on every translation made.
+
+
 .. _custom-checks:
 
 Customizing checks

docs/config.rst

@@ -5,6 +5,25 @@ Configuration
 
 All settings are stored in :file:`settings.py` (as usual for Django).
 
+.. setting:: AUTO_LOCK
+
+AUTO_LOCK
+---------
+
+Enables automatic locking of translation when somebody is working on it.
+
+.. seealso:: :ref:`locking`
+
+.. setting:: LOCK_TIME
+
+LOCK_TIME
+---------
+
+Time in seconds for how long the translation will be locked for single
+translator.
+
+.. seealso:: :ref:`locking`
+
 .. setting:: CHECK_LIST
 
 CHECK_LIST

weblate/settings.py

@@ -278,6 +278,10 @@ LAZY_COMMITS = True
 # Offload indexing
 OFFLOAD_INDEXING = False
 
+# Translation locking
+AUTO_LOCK = True
+LOCK_TIME = 15 * 60
+
 # Where to put Whoosh index
 WHOOSH_INDEX = os.path.join(WEB_ROOT, 'whoosh-index')