From 2eb9604b571d4e93aa2083e5fc4f94b4ae4474a7 Mon Sep 17 00:00:00 2001
From: HonkingGoose <34918129+HonkingGoose@users.noreply.github.com>
Date: Wed, 18 Nov 2020 13:53:44 +0100
Subject: [PATCH] docs: improve versioning documentation (#7753)

---
 docs/usage/modules/versioning.md | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/docs/usage/modules/versioning.md b/docs/usage/modules/versioning.md
index eb6799062f..793ebaf4d8 100644
--- a/docs/usage/modules/versioning.md
+++ b/docs/usage/modules/versioning.md
@@ -1,12 +1,14 @@
 # Versioning
 
-Once Managers have extracted dependencies, and Datasources have located available versions, then Renovate makes use of "Versioning" schemes to perform sorting and filtering of results.
-This is necessary because different managers use different types of numbering/versioning, e.g. `1.0.0-beta.1` in `npm` and `1.0.0b1` in Python.
+Once Managers have extracted dependencies, and Datasources have located available versions, then Renovate will use a "Versioning" scheme to perform sorting and filtering of results.
+The "versioning" is different for each package manager, because different package managers use different versioning schemes.
+For example, `npm` uses`1.0.0-beta.1` and `pip` uses `1.0.0b1`.
 
 ## Configuring Versioning
 
-There are times when you may need to manually configure/override the `versioning` value for a particular dependency.
-You generally won't have a need for this in ecosystems with strict versioning enforcement like `npm`, but you might often need it for ecosystems like Docker where versioning is barely a "convention". e.g.
+You can manually configure/override the `versioning` value for a particular dependency.
+You generally won't need to override the defaults for ecosystems which enforce a strict version scheme like `npm`.
+Configuring or overriding the default `versioning` can be helpful for ecosystems like Docker, where versioning is barely a "convention". e.g.
 
 ```json
 {
-- 
GitLab