python-semver
diff --git a/‎CONTRIBUTING.rst
Lines changed: 2 additions & 2 deletions b/‎CONTRIBUTING.rst
Lines changed: 2 additions & 2 deletions
diff --git a/‎docs/usage/coerce.py renamed to ‎docs/advanced/coerce.py b/‎docs/usage/coerce.py renamed to ‎docs/advanced/coerce.py
diff --git a/‎docs/usage/create-subclasses-from-version.rst renamed to ‎docs/advanced/create-subclasses-from-version.rst b/‎docs/usage/create-subclasses-from-version.rst renamed to ‎docs/advanced/create-subclasses-from-version.rst
diff --git a/‎docs/usage/deal-with-invalid-versions.rst renamed to ‎docs/advanced/deal-with-invalid-versions.rst b/‎docs/usage/deal-with-invalid-versions.rst renamed to ‎docs/advanced/deal-with-invalid-versions.rst
diff --git a/‎docs/usage/display-deprecation-warnings.rst renamed to ‎docs/advanced/display-deprecation-warnings.rst b/‎docs/usage/display-deprecation-warnings.rst renamed to ‎docs/advanced/display-deprecation-warnings.rst
diff --git a/‎docs/advanced/index.rst
Lines changed: 10 additions & 0 deletions b/‎docs/advanced/index.rst
Lines changed: 10 additions & 0 deletions
diff --git a/‎docs/usage/semverwithvprefix.py renamed to ‎docs/advanced/semverwithvprefix.py b/‎docs/usage/semverwithvprefix.py renamed to ‎docs/advanced/semverwithvprefix.py
diff --git a/‎docs/changelog.rst
Lines changed: 2 additions & 0 deletions b/‎docs/changelog.rst
Lines changed: 2 additions & 0 deletions
diff --git a/‎docs/index.rst
Lines changed: 3 additions & 1 deletion b/‎docs/index.rst
Lines changed: 3 additions & 1 deletion
diff --git a/‎docs/migration/index.rst
Lines changed: 9 additions & 0 deletions b/‎docs/migration/index.rst
Lines changed: 9 additions & 0 deletions
@@ -64,7 +64,7 @@ We recommend the following workflow:
    a. Write test cases and run the complete test suite, see :ref:`testsuite`
       for details.
 
-   b. Write a changelog entry, see section :ref:`changelog`.
+   b. Write a changelog entry, see section :ref:`add-changelog`.
 
    c. If you have implemented a new feature, document it into our
       documentation to help our reader. See section :ref:`doc` for
@@ -214,7 +214,7 @@ documentation includes:
     edge cases.
 
 
-.. _changelog:
+.. _add-changelog:
 
 Adding a Changelog Entry
 ------------------------
 
@@ -0,0 +1,10 @@
+Advanced topics
+===============
+
+
+
+.. toctree::
+
+    deal-with-invalid-versions
+    create-subclasses-from-version
+    display-deprecation-warnings
@@ -1 +1,3 @@
+.. _change-log:
+
 .. include:: ../CHANGELOG.rst
@@ -11,7 +11,8 @@ Semver |version| -- Semantic Versioning
 
    install
    usage/index
-   migratetosemver3
+   migration/index
+   advanced/index
    development
    api
 
@@ -31,6 +32,7 @@ Semver |version| -- Semantic Versioning
    changelog
    changelog-semver2
 
+
 Indices and Tables
 ==================
 
 
@@ -0,0 +1,9 @@
+Migrating to semver3
+====================
+
+
+.. toctree::
+    :maxdepth: 1
+
+    migratetosemver3
+    replace-deprecated-functions.rst
Original file line number	Diff line number	Diff line change
`@@ -1 +1,3 @@`
	`1`	`+.. _change-log:`
	`2`	`+`
`1`	`3`	`.. include:: ../CHANGELOG.rst`