diff --git a/docs/usage/java.md b/docs/usage/java.md
index 798bb427af7a18e46dd8ef66331d5333dcf08de8..6684e755ed6e3f87382971f08bca1a644b600648 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