yeast: address review wording in phase docs

Agent-Logs-Url: https://github.com/github/codeql/sessions/6d23db05-a6e9-4de4-8951-b465980fd0ef

Co-authored-by: tausbn <1104778+tausbn@users.noreply.github.com>

Author: Copilot

shared/yeast/doc/yeast.md

@@ -321,8 +321,9 @@ capture name to a field of the same name on the output node.
 A YEAST desugaring pass is configured with a [`DesugaringConfig`], which
 carries one or more named [`Phase`]s of rules and an optional output
 node-types schema (in YAML format). Each phase is a complete traversal
-that runs to completion before the next phase starts; rules in different
-phases never compete for matches. Attach the config to a language spec
+that runs to completion before the next phase starts; only the current
+phase's rules are considered during that traversal. Attach the config to
+a language spec
 to enable rewriting:
 
 ```rust
@@ -349,5 +350,5 @@ is converted to JSON internally).
 
 For the dbscheme/QL code generator, set `Language::desugar` to a
 `DesugaringConfig` carrying the same YAML; the generator converts it to
-JSON for downstream code generation. The `rules` field of the config is
+JSON for downstream code generation. The `phases` field of the config is
 unused at code-generation time.

shared/yeast/src/lib.rs

@@ -638,7 +638,8 @@ fn apply_rules_inner(
 /// One phase of a desugaring pass: a named bundle of rules that runs to
 /// completion (a full traversal applying its rules) before the next phase
 /// starts. Rules within a phase compete for matches as usual; rules in
-/// different phases never compete because they don't see each other's input.
+/// different phases never compete because each traversal only considers the
+/// current phase's rules.
 pub struct Phase {
     /// Name used in error messages.
     pub name: String,