From 277d022e032b5fd7d8e9c8fc494444653a1f81e5 Mon Sep 17 00:00:00 2001
From: HonkingGoose <34918129+HonkingGoose@users.noreply.github.com>
Date: Thu, 3 Dec 2020 08:32:52 +0100
Subject: [PATCH] docs: improve Java documentation (#7821)

Co-authored-by: Rhys Arkins <rhys@arkins.net>
Co-authored-by: Michael Kriese <michael.kriese@visualon.de>
---
 docs/usage/java.md | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/docs/usage/java.md b/docs/usage/java.md
index 798bb427af..6684e755ed 100644
--- a/docs/usage/java.md
+++ b/docs/usage/java.md
@@ -5,27 +5,28 @@ description: Java versions support in Renovate
 
 # Java Dependency Updates
 
-Renovate can update the version used in Gradle and Maven projects.
+Renovate can update Gradle and Maven dependencies.
 This includes libraries and plugins.
 
 ## Gradle
 
-Renovate detects versions specified as string `'group:artifact:version'` and as a map `(group:groupName, name:ArtifactName, version:Version)`.
+Renovate detects versions that are specified in a string `'group:artifact:version'` and those specified in a map `(group:groupName, name:ArtifactName, version:Version)`.
 
 ### File Support
 
-Renovate can update `build.gradle`/`build.gradle.kts` files in the root of the repository and any `*.gradle`/`*.gradle.kts` file inside any subdirectory as multi-project configurations.
+Renovate can update `build.gradle`/`build.gradle.kts` files in the root of the repository.
+It also updates any `*.gradle`/`*.gradle.kts` files in a subdirectory as multi-project configurations.
 
 Renovate does not support:
 
-- Projects with neither `build.gradle` nor `build.gradle.kts` in the root of the repository
+- Projects which do not have either a `build.gradle` or `build.gradle.kts` in the repository root
 - Android projects that require extra configuration to run (e.g. setting the Android SDK)
 - Gradle versions prior to version 5.0.
 
 ### How It Works
 
 Renovate uses a plugin to search and extract versions from projects.
-They are then looked up using Maven datasources and patched into PRs the usual way.
+Once the Gradle plugin has detected the dependencies, lookups and updating will be performed like usual with datasources and direct patching of files.
 
 ## Maven
 
@@ -33,7 +34,7 @@ Renovate can update dependency versions found in Maven `pom.xml` files.
 
 ### File Support
 
-Renovate will search repositories for all files named `pom.xml` and then process them independently.
+Renovate will search repositories for all `pom.xml` files and processes them independently.
 
 ### Custom registry support, and authentication
 
-- 
GitLab