python-semver · tomschr · Oct 26, 2020 · Oct 26, 2020
diff --git a/CHANGELOG.rst b/CHANGELOG.rst
@@ -16,6 +16,94 @@ in our repository.
 
 .. towncrier release notes start
 
+Version 3.0.0-dev.1
+===================
+
+:Released: 2020-10-26
+:Maintainer: Tom Schraitle
+
+
+Deprecations
+------------
+
+* :pr:`290`: For semver 3.0.0-alpha0:
+
+  * Remove anything related to Python2
+  * In :file:`tox.ini` and :file:`.travis.yml`
+    Remove targets py27, py34, py35, and pypy.
+    Add py38, py39, and nightly (allow to fail)
+  * In :file:`setup.py` simplified file and remove
+    ``Tox`` and ``Clean`` classes
+  * Remove old Python versions (2.7, 3.4, 3.5, and pypy)
+    from Travis
+
+* :gh:`234`: In :file:`setup.py` simplified file and remove
+  ``Tox`` and ``Clean`` classes
+
+
+
+Features
+--------
+
+* :pr:`290`: Create semver 3.0.0-alpha0
+
+  * Update :file:`README.rst`, mention maintenance
+    branch ``maint/v2``.
+  * Remove old code mainly used for Python2 compatibility,
+    adjusted code to support Python3 features.
+  * Split test suite into separate files under :file:`tests/`
+    directory
+  * Adjust and update :file:`setup.py`. Requires Python >=3.6.*
+    Extract metadata directly from source (affects all the ``__version__``,
+    ``__author__`` etc. variables)
+
+* :gh:`270`: Configure Towncrier (:pr:`273`:)
+
+  * Add :file:`changelog.d/.gitignore` to keep this directory
+  * Create :file:`changelog.d/README.rst` with some descriptions
+  * Add :file:`changelog.d/_template.rst` as Towncrier template
+  * Add ``[tool.towncrier]`` section in :file:`pyproject.toml`
+  * Add "changelog" target into :file:`tox.ini`. Use it like
+    :command:`tox -e changelog -- CMD` whereas ``CMD`` is a
+    Towncrier command. The default :command:`tox -e changelog`
+    calls Towncrier to create a draft of the changelog file
+    and output it to stdout.
+  * Update documentation and add include a new section
+    "Changelog" included from :file:`changelog.d/README.rst`.
+
+* :gh:`276`: Document how to create a sublass from :class:`VersionInfo` class
+
+
+
+Bug Fixes
+---------
+
+* :gh:`291`: Disallow negative numbers in VersionInfo arguments
+  for ``major``, ``minor``, and ``patch``.
+
+
+
+Improved Documentation
+----------------------
+
+* :pr:`290`: Several improvements in the documentation:
+
+  * New layout to distinguish from the semver2 development line.
+  * Create new logo.
+  * Remove any occurances of Python2.
+  * Describe changelog process with Towncrier.
+  * Update the release process.
+
+
+
+Trivial/Internal Changes
+------------------------
+
+* :pr:`290`: Add supported Python versions to :command:`black`.
+
+
+
+----
 
 
 Version 2.13.0

diff --git a/README.rst b/README.rst
@@ -1,3 +1,8 @@
+.. warning::
+
+   This is a development version. Do **NOT** use it
+   in production before the final 3.0.0 is released.
+
 Quickstart
 ==========
 

diff --git a/changelog.d/234.deprecation.rst b/changelog.d/234.deprecation.rst
diff --git a/changelog.d/270.feature.rst b/changelog.d/270.feature.rst
diff --git a/changelog.d/276.feature.rst b/changelog.d/276.feature.rst
diff --git a/changelog.d/291.bugfix.rst b/changelog.d/291.bugfix.rst
diff --git a/changelog.d/pr290.deprecation.rst b/changelog.d/pr290.deprecation.rst
diff --git a/changelog.d/pr290.doc.rst b/changelog.d/pr290.doc.rst
diff --git a/changelog.d/pr290.feature.rst b/changelog.d/pr290.feature.rst
diff --git a/changelog.d/pr290.trivial.rst b/changelog.d/pr290.trivial.rst
diff --git a/docs/index.rst b/docs/index.rst
@@ -1,12 +1,14 @@
 Semver |version| -- Semantic Versioning
 =======================================
 
+.. include:: readme.rst
+
 
 .. toctree::
    :maxdepth: 2
    :caption: Contents
+   :hidden:
 
-   readme
    install
    usage
    development
@@ -15,12 +17,15 @@ Semver |version| -- Semantic Versioning
 .. toctree::
    :maxdepth: 2
    :caption: CLI
+   :hidden:
 
    pysemver
 
 
 .. toctree::
    :maxdepth: 1
+   :caption: Changelogs
+   :hidden:
 
    changelog
    changelog-2.7.9-and-before