Wording improvements

api/src/main/java/jakarta/enterprise/inject/spi/BeanContainer.java

@@ -37,6 +37,7 @@
  * </pre>
  *
  * @author Matej Novotny
+ * @since 4.0
  */
 public interface BeanContainer {
 

api/src/main/java/jakarta/enterprise/inject/spi/ObserverMethod.java

@@ -66,6 +66,7 @@ public interface ObserverMethod<T> extends Prioritized {
      * </p>
      *
      * @return the declaring {@linkplain Bean bean}
+     * @since 4.0
      */
     default Bean<?> getDeclaringBean() {
         return null;

spec/src/main/asciidoc/core/events.asciidoc

@@ -219,9 +219,9 @@ If the runtime type of the event object contains an unresolvable type variable,
 
 ==== Assignability of type variables, raw and parameterized types
 
-An event type is considered assignable to a type variable if the event type is assignable to the upper bound, if any.
+An event type is considered assignable to an observed event type that is a type variable if the event type is assignable to the upper bound of the type variable, if any.
 
-A raw event type is considered assignable to a parameterized observed event type if the raw types are identical and all type parameters of the required type are either unbounded type variables or `java.lang.Object`.
+A raw event type is considered assignable to a parameterized observed event type if the raw types are identical and all type parameters of the observed event type are either unbounded type variables or `java.lang.Object`.
 
 A parameterized event type is considered assignable to a raw observed event type if the raw types are identical.
 

spec/src/main/asciidoc/core/implementation.asciidoc

@@ -379,7 +379,7 @@ If a method has more than one parameter annotated `@Disposes`, the container aut
 If a disposer method is annotated `@Produces` or `@Inject`, has a parameter annotated `@Observes` or has a parameter annotated `@ObservesAsync`, the container automatically detects the problem and treats it as a definition error.
 
 Interceptors may not declare disposer methods.
-If an interceptor has a method annotated `@Disposes`, the container automatically detects the problem and treats it as a definition error.
+If an interceptor has a method that has a parameter annotated `@Disposes`, the container automatically detects the problem and treats it as a definition error.
 
 In addition to the disposed parameter, a disposer method may declare additional parameters, which may also specify qualifiers.
 These additional parameters are injection points.

spec/src/main/asciidoc/core/inheritance_full.asciidoc

@@ -128,7 +128,7 @@ public class MockAsynchronousService extends AsynchronousService {
 }
 ----
 
-When an enabled bean, as defined in <<enablement>>, specializes a second bean, we can be certain that the second bean is never instantiated or called by the container.
+When an enabled bean, as defined in <<enablement_full>>, specializes a second bean, we can be certain that the second bean is never instantiated or called by the container.
 Even if the second bean defines a producer or observer method, the method will never be called.
 
 [[direct_and_indirect_specialization]]