From f4ad902d1d8f38b2000465af3123f389af2e7d7f Mon Sep 17 00:00:00 2001
From: HonkingGoose <34918129+HonkingGoose@users.noreply.github.com>
Date: Mon, 25 Sep 2023 16:03:07 +0200
Subject: [PATCH] docs: rewrite git-refs readme (#24643)

Co-authored-by: Rhys Arkins <rhys@arkins.net>
---
 lib/modules/datasource/git-refs/readme.md | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/lib/modules/datasource/git-refs/readme.md b/lib/modules/datasource/git-refs/readme.md
index 0e0a989bc8..9b4da720fb 100644
--- a/lib/modules/datasource/git-refs/readme.md
+++ b/lib/modules/datasource/git-refs/readme.md
@@ -1,13 +1,15 @@
-This datasource can be used in combination with [regex managers](https://docs.renovatebot.com/modules/manager/regex/) to keep dependencies up-to-date which are not specifically supported by Renovate.
+You can use this datasource plus [regex managers](https://docs.renovatebot.com/modules/manager/regex/) to update git-based dependencies that are not natively supported by Renovate.
+
+The `git-refs` datasource returns a reference from a Git repository.
 
-This datasource returns a reference from a Git repository.
 The `packageName` must be a fully qualified domain name.
-To fetch the latest digest of a reference instead of the named reference, specify the reference as the `currentValue` and match on the `currentDigest`.
+
+To fetch the latest _digest_ of a reference instead of the named reference: put the named reference in `currentValue` and match on the `currentDigest`.
 
 **Usage example**
 
-The following is an example where you would maintain the HEAD digest of the `master` branch of a repository.
-You would configure a custom manager in `renovate.json` for files named `versions.ini`:
+Say you want to maintain the `HEAD` digest of the `master` branch of a repository.
+You would configure a custom manager in your Renovate config file for files named `versions.ini`:
 
 ```json
 {
-- 
GitLab