gnodet opened a new pull request, #12872: URL: https://github.com/apache/maven/pull/12872
## Summary - Add `@deprecated` Javadoc tags with replacement guidance to 9 deprecated elements across `maven.mdo` and `settings.mdo` that were missing "what to use instead" information - Covers both the API model (`org.apache.maven.api.model`) and the compat model (`org.apache.maven.model`) as well as `org.apache.maven.settings` ### Changes | Element | Guidance Added | |---|---| | `Notifier.address` | Use the `configuration` properties map | | `Model.getProjectDirectory()` | Use `getProjectDirectoryPath()` (returns `Path`) | | `ModelBase.reports` | Use the `reporting` element | | `ConfigurationContainer.unsetInheritanceApplied()` | No-op, no replacement | | `ConfigurationContainer.setInherited(boolean)` | Use `setInherited(String)` | | `Plugin.goals` | Use `executions` | | `Plugin.flushExecutionMap()` | No-op, no replacement | | `Reporting.flushReportPluginMap()` | No-op, no replacement | | `Settings.getMirrorOf(String)` | Use the Maven mirror matching infrastructure | Elements that already had proper guidance (e.g., `modules` → `subprojects`, `sourceDirectory` → `<Source>` elements, `Resource` → `<Source>` with `resources` language) were left unchanged. ## Test plan - [x] `mvn test -pl api/maven-api-model,compat/maven-model,api/maven-api-settings,compat/maven-settings` passes - [x] Verified generated Java sources contain the updated `@deprecated` tags - [x] Documentation-only changes — no behavioral impact 🤖 Generated with [Claude Code](https://claude.com/claude-code) -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
