Deprecated model API methods lack documented rationale and replacement #11674
Description
Affected version
4.0.0+
Bug description
While reviewing the Maven model API documentation, I noticed that the
getPomFile() and setPomFile(File) methods are marked as deprecated
but do not document the reason for deprecation, the recommended
replacement, or the version since which they are deprecated.
These methods appear in the generated public API from
api/maven-api-model/src/main/mdo/maven.mdo, so the lack of deprecation
context makes it harder for users to understand how they should migrate
away from these APIs.
This issue is documentation-related only; no functional or behavioral
changes are implied.