diff --git a/akka-docs/src/main/paradox/common/may-change.md b/akka-docs/src/main/paradox/common/may-change.md index 1dc137ed71..7849ea0b1b 100644 --- a/akka-docs/src/main/paradox/common/may-change.md +++ b/akka-docs/src/main/paradox/common/may-change.md @@ -11,7 +11,7 @@ Concretely **may change** means that an API or module is in early access mode an * may have its API change in breaking ways in minor releases * may be entirely dropped from Akka in a minor release -Complete modules can be marked as **may change**, this will can be found in their module description and in the docs. +Complete modules can be marked as **may change**, which will be stated in the module's description and in the docs. Individual public APIs can be annotated with `akka.api.annotation.ApiMayChange` to signal that it has less guarantees than the rest of the module it lives in. For example, when while introducing "new" Java 8 APIs into