diff --git a/CHANGELOG.rst b/CHANGELOG.rst
index f0c8a28..e489a81 100644
--- a/CHANGELOG.rst
+++ b/CHANGELOG.rst
@@ -1,47 +1,30 @@
-### Changelog
+Changelog
+=========
 
-All notable changes to this project will be documented in this file. Dates are displayed in UTC.
+Version 0.1.5
+-------------
+- This updates Scipy for gaussian_filter (#20)
+- Update thalamus (#18)
+- Update condition for error from layer queries. Fix #16 (#17)
 
-Generated by [`auto-changelog`](https://github.com/CookPete/auto-changelog).
+Version 0.1.4
+-------------
 
-#### [v0.1.5](https://github.com/BlueBrain/atlas-direction-vectors/compare/v0.1.4...v0.1.5)
+- Added `direction-vectors from-center` command; a placeholder way to generate
+  orientation vectors for a particular region, by supplying a central point,
+  and emanating away
 
-- This updates Scipy for gaussian_filter [`#20`](https://github.com/BlueBrain/atlas-direction-vectors/pull/20)
-- Update thalamus [`#18`](https://github.com/BlueBrain/atlas-direction-vectors/pull/18)
-- Update condition for error from layer queries. Fix #16 [`#17`](https://github.com/BlueBrain/atlas-direction-vectors/pull/17)
-- Generalization of cerebellar cortex direction vectors computation. [`#9`](https://github.com/BlueBrain/atlas-direction-vectors/pull/9)
-- Update condition for error from layer queries. Fix #16 (#17) [`#16`](https://github.com/BlueBrain/atlas-direction-vectors/issues/16) [`#16`](https://github.com/BlueBrain/atlas-direction-vectors/issues/16)
-- update changelog [`ffb4808`](https://github.com/BlueBrain/atlas-direction-vectors/commit/ffb480823ba04d77cd9002d7862d350badc0fe26)
+Version 0.1.2
+-------------
 
-#### [v0.1.4](https://github.com/BlueBrain/atlas-direction-vectors/compare/v0.1.3...v0.1.4)
+- Make 2 direction builders available in the `atlas-direction-vectors direction-vectors` application:
+    * layer-region: can specify for any layered region what the values are for
+      certain layer voxels, such that the blur-gradient is more accurate
 
-> 6 January 2023
+Version 0.1.1
+-------------
+- Open source release
 
-- make numpy typing optional [`#14`](https://github.com/BlueBrain/atlas-direction-vectors/pull/14)
-- * Make `--region` required for `direction_vectors from-center` [`186a764`](https://github.com/BlueBrain/atlas-direction-vectors/commit/186a7644acffe1845dfef2154788abcf29c81972)
-
-#### [v0.1.3](https://github.com/BlueBrain/atlas-direction-vectors/compare/v0.1.2...v0.1.3)
-
-> 4 January 2023
-
-- update github actions [`#13`](https://github.com/BlueBrain/atlas-direction-vectors/pull/13)
-- NSETM-2084 direction vectors from center [`#10`](https://github.com/BlueBrain/atlas-direction-vectors/pull/10)
-- Cleanup [`#12`](https://github.com/BlueBrain/atlas-direction-vectors/pull/12)
-- Citation section and badge added [`#8`](https://github.com/BlueBrain/atlas-direction-vectors/pull/8)
-- added orientation example [`#6`](https://github.com/BlueBrain/atlas-direction-vectors/pull/6)
-- fix failing linting [`#7`](https://github.com/BlueBrain/atlas-direction-vectors/pull/7)
-
-#### [v0.1.2](https://github.com/BlueBrain/atlas-direction-vectors/compare/v0.1.1...v0.1.2)
-
-> 18 May 2022
-
-- Make `layer_based_direction_vectors` generation available from commandline [`#5`](https://github.com/BlueBrain/atlas-direction-vectors/pull/5)
-- Make hemisphere handling an enum instead of a dict [`#4`](https://github.com/BlueBrain/atlas-direction-vectors/pull/4)
-
-#### v0.1.1
-
-> 10 March 2022
-
-- Initial commit: extracts the direction_vectors module from atlas-building-tools [NSETM-1685] [`f91b0cd`](https://github.com/BlueBrain/atlas-direction-vectors/commit/f91b0cdb84aee1d99e8ab9ff81767fdc0bd05520)
-- OSS requirements [`600b42d`](https://github.com/BlueBrain/atlas-direction-vectors/commit/600b42d03a222ae2fd8df0e5ed565516b5ddd4df)
-- switch to numpy.typing [`72b08aa`](https://github.com/BlueBrain/atlas-direction-vectors/commit/72b08aa23d7091a99ca4cc550c1f793259f49fe0)
+Version 0.1.0
+-------------
+- Initial commit: extracts the `direction_vectors` from internal tools
diff --git a/README.rst b/README.rst
index afa47bb..2e34666 100644
--- a/README.rst
+++ b/README.rst
@@ -1,4 +1,4 @@
-.. image:: atlas-direction-vectors.jpg
+|banner|
 
 Overview
 =========
@@ -94,4 +94,8 @@ The development of this software was supported by funding to the Blue Brain Proj
 
 For license and authors, see LICENSE.txt and AUTHORS.txt respectively.
 
-Copyright © 2022 Blue Brain Project/EPFL
+Copyright © 2022-2024 Blue Brain Project/EPFL
+
+.. substitutions
+
+.. |banner| image:: doc/source/static/atlas-direction-vectors.jpg
diff --git a/doc/source/direction_vectors.rst b/doc/source/direction_vectors.rst
index db0c939..8adf36a 100644
--- a/doc/source/direction_vectors.rst
+++ b/doc/source/direction_vectors.rst
@@ -5,4 +5,3 @@ Direction vectors
 
 .. click:: atlas_direction_vectors.app.direction_vectors:app
     :prog: direction_vectors
-    :nested: full
diff --git a/doc/source/readme.rst b/doc/source/readme.rst
index a6210d3..7243a07 100644
--- a/doc/source/readme.rst
+++ b/doc/source/readme.rst
@@ -1 +1,4 @@
 .. include:: ../../README.rst
+   :end-before: .. substitutions
+
+.. |banner| image:: static/atlas-direction-vectors.jpg
diff --git a/atlas-direction-vectors.jpg b/doc/source/static/atlas-direction-vectors.jpg
similarity index 100%
rename from atlas-direction-vectors.jpg
rename to doc/source/static/atlas-direction-vectors.jpg
diff --git a/tox.ini b/tox.ini
index efb5232..852b2c5 100644
--- a/tox.ini
+++ b/tox.ini
@@ -47,7 +47,7 @@ deps =
     sphinx-bluebrain-theme
     sphinx-click
 commands = make html SPHINXOPTS=-W
-whitelist_externals = make
+allowlist_externals = make
 
 [testenv:check-packaging]
 deps =