Update documentation

tomschr · tomschr · commit 0c6f02ebe1db · 2020-11-10T08:43:34.000+01:00
diff --git a/docs/migratetosemver3.rst b/docs/migratetosemver3.rst
@@ -1,5 +1,6 @@
 .. _semver2-to-3:
 
+
 Migrating from semver2 to semver3
 =================================
 
@@ -14,8 +15,8 @@ For a more detailed overview of all the changes, refer
 to our :ref:`changelog`.
 
 
-Use Version instead of VersionInfo
-----------------------------------
+Use :class:`Version` instead of :class:`VersionInfo`
+----------------------------------------------------
 
 The :class:`VersionInfo` has been renamed to :class:`Version`
 to have a more succinct name.
@@ -29,9 +30,20 @@ If you still need the old version, use this line:
    from semver.version import Version as VersionInfo
 
 
+Use :class:`Version` instead of :meth:`Version.parse`
+-----------------------------------------------------
+
+The :class:`~semver.version.Version` class supports now different variants
+how a version can be called (see section :ref:`sec_creating_version`
+for more details).
+
+It's important to know that you do not need to use
+:meth:`Version.parse <semver.version.Version.parse>` anymore. You
+can pass a string directly to :class:`~semver.Version`.
+
 
-Use semver.cli instead of semver
---------------------------------
+Use :mod:`semver.cli` instead of :mod:`semver`
+----------------------------------------------
 
 All functions related to CLI parsing are moved to :mod:`semver.cli`.
 If you are such functions, like :func:`semver.cmd_bump <semver.cli.cmd_bump>`,
diff --git a/docs/usage.rst b/docs/usage.rst
@@ -29,6 +29,8 @@ To know the version of semver itself, use the following construct::
    '3.0.0-dev.2'
 
 
+.. _sec_creating_version:
+
 Creating a Version
 ------------------
 
