diff --git a/spring-boot-project/spring-boot-properties-migrator/src/main/java/org/springframework/boot/context/properties/migrator/PropertiesMigrationReporter.java b/spring-boot-project/spring-boot-properties-migrator/src/main/java/org/springframework/boot/context/properties/migrator/PropertiesMigrationReporter.java
index a37aa1f4ed9..813a0ac3670 100644
--- a/spring-boot-project/spring-boot-properties-migrator/src/main/java/org/springframework/boot/context/properties/migrator/PropertiesMigrationReporter.java
+++ b/spring-boot-project/spring-boot-properties-migrator/src/main/java/org/springframework/boot/context/properties/migrator/PropertiesMigrationReporter.java
@@ -41,7 +41,7 @@ import org.springframework.util.MultiValueMap;
 import org.springframework.util.StringUtils;
 
 /**
- * Report on {@link PropertyMigration legacy properties}.
+ * Report on {@link PropertyMigration properties migration}.
  *
  * @author Stephane Nicoll
  */
@@ -61,7 +61,7 @@ class PropertiesMigrationReporter {
 	/**
 	 * Analyse the {@link ConfigurableEnvironment environment} and attempt to rename
 	 * legacy properties if a replacement exists.
-	 * @return the analysis
+	 * @return a report of the migration
 	 */
 	public PropertiesMigrationReport getReport() {
 		PropertiesMigrationReport report = new PropertiesMigrationReport();
diff --git a/spring-boot-project/spring-boot-properties-migrator/src/main/java/org/springframework/boot/context/properties/migrator/PropertyMigration.java b/spring-boot-project/spring-boot-properties-migrator/src/main/java/org/springframework/boot/context/properties/migrator/PropertyMigration.java
index 9a2ca673d6a..d98a08d783e 100644
--- a/spring-boot-project/spring-boot-properties-migrator/src/main/java/org/springframework/boot/context/properties/migrator/PropertyMigration.java
+++ b/spring-boot-project/spring-boot-properties-migrator/src/main/java/org/springframework/boot/context/properties/migrator/PropertyMigration.java
@@ -24,7 +24,7 @@ import org.springframework.boot.origin.Origin;
 import org.springframework.boot.origin.TextResourceOrigin;
 
 /**
- * Description of a legacy property.
+ * Description of a property migration.
  *
  * @author Stephane Nicoll
  */