Apply review feedback.

Author: kirbyt

stdlib/public/Observation/Sources/Observation/Observable.swift

@@ -53,7 +53,7 @@ public macro Observable() =
 
 /// Synthesizes a property for accessors.
 ///
-/// The ``Observation`` framework uses this macro. Its use outside of the
+/// The ``Observation`` module uses this macro. Its use outside of the
 /// framework isn't necessary.
 @available(SwiftStdlib 5.9, *)
 @attached(accessor, names: named(init), named(get), named(set))
@@ -63,7 +63,7 @@ public macro Observable() =
 public macro ObservationTracked() =
   #externalMacro(module: "ObservationMacros", type: "ObservationTrackedMacro")
 
-/// Turns off observation tracking of a property.
+/// Disables observation tracking of a property.
 ///
 /// By default, an object can observe any property of an observable type that
 /// is accessible to the observing object. To prevent observation of an

stdlib/public/Observation/Sources/Observation/ObservationRegistrar.swift

@@ -148,6 +148,8 @@ public struct ObservationRegistrar: Sendable {
 
   /// Identifies mutations to the transactions registered for observers.
   ///
+  /// This method calls ``willset(_:keypath:)`` before the mutation. Then it
+  /// calls ``didset(_:keypath:)`` after the mutation.
   /// - Parameters:
   ///   - of: An instance of an observable type.
   ///   - keyPath: The key path of an observed property.