@@ -1,128 +1,187 @@
+.. _debops-tools__ref_changelog:
+
 Changelog
 =========
 
 .. include:: includes/all.rst
 
-v0.4.4
-------
+**debops-tools**
 
-*Released: 2016-06-29*
+This project adheres to `Semantic Versioning <http://semver.org/spec/v2.0.0.html>`__
+and `human-readable changelog <http://keepachangelog.com/en/0.3.0/>`__.
 
-- Document ``python-passlib`` dependency. [barraponto]
+The current repository maintainer_ is drybjed_.
 
-- Fix issue with ``bootstrap-ansible.sh`` script not able to install latest
-  Ansible stable version, make the process more verbose and don't remove the
-  temporary directory by default. [drybjed_]
+`debops-tools master`_ - unreleased
+-----------------------------------
 
-- Update Ansible Galaxy role links in ``ansigenome`` templates. [drybjed_]
+.. _debops-tools master: https://github.com/debops/debops-tools/compare/v0.4.4...master
 
-- Fix Unicode support in ``debops-defaults``, it should now output readable
-  text in the editor. [ypid_]
+Changed
+~~~~~~~
 
-- Document :command:`git` dependency. [violuke]
+- Rewrite Changelog in the new format. [drybjed_]
 
-- Update the Ansigenome ``README.md`` template used to generate role README
-  files to use ``galaxy_url`` instead of ``galaxy_id``. The new variable should
-  contain full URL of the role on Ansible Galaxy. [drybjed_]
+
+`debops-tools v0.4.4`_ - 2016-06-29
+-----------------------------------
+
+.. _debops-tools v0.4.4: https://github.com/debops/debops-tools/compare/v0.4.3...v0.4.4
+
+Added
+~~~~~
+
+- Document ``python-passlib`` dependency. [barraponto]
+
+- Document :command:`git` dependency. [violuke]
 
 - Add useful Ansible options to default ``ansible.cfg`` template.
 
   By default Ansible will not display skipped hosts during the playbook run,
   and "retry" files won't be generated. [drybjed_]
 
+Changed
+~~~~~~~
+
+- Update Ansible Galaxy role links in ``ansigenome`` templates. [drybjed_]
+
+- Update the Ansigenome ``README.md`` template used to generate role README
+  files to use ``galaxy_url`` instead of ``galaxy_id``. The new variable should
+  contain full URL of the role on Ansible Galaxy. [drybjed_]
+
 - Update generated inventory file with more relevant information. [drybjed_]
 
 - Update documentation. [drybjed_]
 
-v0.4.3
-------
+Fixed
+~~~~~
+
+- Fix issue with ``bootstrap-ansible.sh`` script not able to install latest
+  Ansible stable version, make the process more verbose and don't remove the
+  temporary directory by default. [drybjed_]
+
+- Fix Unicode support in ``debops-defaults``, it should now output readable
+  text in the editor. [ypid_]
+
 
-*Released: 2015-05-25*
+`debops-tools v0.4.3`_ - 2015-05-25
+-----------------------------------
+
+.. _debops-tools v0.4.3: https://github.com/debops/debops-tools/compare/v0.4.2...v0.4.3
+
+Changed
+~~~~~~~
 
 - Rearranged documentation. [drybjed_]
 
-- Properly propagate exit code when running debops [do3cc_]
+- Properly propagate exit code when running :command:`debops`. [do3cc_]
 
 - Clone and update roles exclusively over HTTPS to allow operation
   over a proxy or in case the git protocol is blocked. [ganto_]
 
-v0.4.2
-------
 
-*Released: 2015-03-04*
+`debops-tools v0.4.2`_ - 2015-03-04
+-----------------------------------
+
+.. _debops-tools v0.4.2: https://github.com/debops/debops-tools/compare/v0.4.1...v0.4.2
+
+Added
+~~~~~
+
+- Add a work-around for ansible's buggy handling of paths containing
+  spaces. [htgoebel_]
+
+Changed
+~~~~~~~
 
 - On OS X search config-file in :file:`/etc` too (before searching in
   ``~/Library/Application Support``). [htgoebel_]
 
 - Make debops-init write some example values into .debops.cfg.
   [htgoebel_]
 
-- Add a work-around for ansible's buggy handling of paths containing
-  spaces. [htgoebel_]
 
+`debops-tools v0.4.1`_ - 2015-02-26
+-----------------------------------
+
+.. _debops-tools v0.4.1: https://github.com/debops/debops-tools/compare/v0.4.0...v0.4.1
 
-v0.4.1
-------
+Added
+~~~~~
 
-*Released: 2015-02-26*
+- Add :file:`library/` path to default Ansible plugin paths in generated ``ansible.cfg``. [drybjed_]
+
+- Define default ``ansible_managed`` variable in generated ``ansible.cfg``. [drybjed_]
+
+Changed
+~~~~~~~
 
 - Update role README template to point to new documentation. [drybjed_]
 
 - Make Travis mass test script less noisy. [drybjed_]
 
-- Add :file:`library/` path to default Ansible plugin paths in generated ``ansible.cfg``. [drybjed_]
+- Changelog is rewritten in reStructuredText. [drybjed_]
 
-- Define default ``ansible_managed`` variable in generated ``ansible.cfg``. [drybjed_]
 
-- Changelog is rewritten in reStructuredText. [drybjed_]
+`debops-tools v0.4.0`_ - 2015-02-12
+-----------------------------------
 
-v0.4.0
-------
+.. _debops-tools v0.4.0: https://github.com/debops/debops-tools/compare/v0.3.0...v0.4.0
 
-*Released: 2015-02-12*
+Changed
+~~~~~~~
 
 - DebOps can now use a system-wide configuration file `/etc/debops.cfg`. You
   can also install DebOps playbooks and roles in a system-wide location. [htgoebel_]
 
-v0.3.0
-------
 
-*Released: 2015-01-27*
+`debops-tools v0.3.0`_ - 2015-01-27
+-----------------------------------
+
+.. _debops-tools v0.3.0: https://github.com/debops/debops-tools/compare/v0.2.0...v0.3.0
+
+Changed
+~~~~~~~
 
 - Small fixes for bugs in DebOps libraries which prevented correct script
   execution on platforms other than Linux. [htgoebel_]
 
-v0.2.0
-------
 
-*Released: 2015-01-26*
+`debops-tools v0.2.0`_ - 2015-01-26
+-----------------------------------
+
+.. _debops-tools v0.2.0: https://github.com/debops/debops-tools/compare/v0.1.0...v0.2.0
+
+Changed
+~~~~~~~
 
-- :command:`debops-padlock` script has been modified to support "lock" and "unlock"
-  sub-commands and it is now used by the `padlock` wrapper script to lock and
-  unlock EncFS-encrypted secret directory. [htgoebel_]
+- The :command:`debops-padlock` script has been modified to support "lock" and
+  "unlock" sub-commands and it is now used by the `padlock` wrapper script to
+  lock and unlock EncFS-encrypted secret directory. [htgoebel_]
 
-- ``debops`` script can now read configuration from several files::
+- The ``debops`` script can now read configuration from several files:
 
-    /etc/debops.cfg
-    $XDG_CONFIG_DIRS/debops.cfg (defaults to ~/etc/xdg/debops.cfg)
-    $XDG_CONFIG_HOME/debops.cfg (defaults to ~/.config/debops.cfg)
-    ./.debops.cfg
+  .. code-block:: none
+
+     /etc/debops.cfg
+     $XDG_CONFIG_DIRS/debops.cfg (defaults to ~/etc/xdg/debops.cfg)
+     $XDG_CONFIG_HOME/debops.cfg (defaults to ~/.config/debops.cfg)
+     ./.debops.cfg
 
   Configuration options from different files are merged together. [htgoebel_]
 
 - Scripts are now tested on Travis-CI using `nosetests`. [drybjed_]
 
 
-v0.1.0
-------
+debops-tools v0.1.0 - 2014-12-14
+--------------------------------
 
-*Released: 2014-12-14*
+Changed
+~~~~~~~
 
 - Scripts are completely rewritten in Python by Hartmut Goebel. This saves
   a lot of code allows for more fertile future changes.
 
-Notable changed related to the shell-version are:
-
 - Playbooks are no longer searched in :file:`/usr/local/share/debops` nor in
   :file:`/usr/share/debops`. We assume DebOps is used from a user account,
   so installing playbooks globally is not the common case.
@@ -142,8 +201,9 @@ Notable changed related to the shell-version are:
 - The padlock script still exists and has been simplified a lot. Most
   functionality has been moved into the DebOps python library.
 
-Pre-release
------------
+
+debops-tools pre-v0.1.0
+-----------------------
 
 2014-12-02
 ~~~~~~~~~~
@@ -183,7 +243,7 @@ Pre-release
 2014-10-21
 ~~~~~~~~~~
 
-* `DebOps documentation`_ website has been opened to keep documentation in one
+- `DebOps documentation`_ website has been opened to keep documentation in one
   easily searchable place. It's based on `ReadTheDocs`_. All documentation
   already written has been moved from ``debops/debops`` repository to the new
   website, more to come.