diff --git a/crates/moon-derive-refineable/src/derive_refineable.rs b/crates/moon-derive-refineable/src/derive_refineable.rs
index c7c8a91..0cf42ef 100644
--- a/crates/moon-derive-refineable/src/derive_refineable.rs
+++ b/crates/moon-derive-refineable/src/derive_refineable.rs
@@ -487,7 +487,8 @@ pub fn derive_refineable(input: TokenStream) -> TokenStream {
         impl #impl_generics #refinement_ident #ty_generics
             #where_clause
         {
-            /// Returns `true` if all fields are `Some`
+            /// Returns `true` if any field is set: a plain field holds `Some`, or a nested
+            /// refinement field has any field set.
             pub fn is_some(&self) -> bool {
                 #(
                     if self.#field_names.is_some() {
diff --git a/docs/MOON_PATCH_QUEUE.md b/docs/MOON_PATCH_QUEUE.md
index 237368d..66e2f71 100644
--- a/docs/MOON_PATCH_QUEUE.md
+++ b/docs/MOON_PATCH_QUEUE.md
@@ -16,9 +16,12 @@ generated tree.
 Regeneration command:
 
 ```powershell
-cargo xtask transform --zed-tag v0.0.0 --zed-path R:\test\_zed_gpui_base_84b753 --output crates --local
+cargo xtask transform --zed-tag v0.0.0 --zed-path R:\test\_zed_gpui_base_84b753 --output crates
 ```
 
+The generated crates use path dependencies by default; `--versioned-deps`
+switches them to version dependencies for publish-style output.
+
 ## Patch Layers On `master`
 
 0. Standalone extraction hygiene on `upstream-clean`: