Apply suggestions from code review

Co-authored-by: Laurent Quérel <[email protected]>

src/registry/check.rs

@@ -48,7 +48,7 @@ pub struct RegistryCheckArgs {
     #[command(flatten)]
     pub diagnostic: DiagnosticArgs,
 
-    /// Weaver parameters
+    /// Common weaver registry parameters
     #[command(flatten)]
     pub common_registry_args: CommonRegistryArgs,
 }

src/registry/generate.rs

@@ -74,7 +74,7 @@ pub struct RegistryGenerateArgs {
     #[command(flatten)]
     pub diagnostic: DiagnosticArgs,
 
-    /// Weaver parameters
+    /// Common weaver registry parameters
     #[command(flatten)]
     pub common_registry_args: CommonRegistryArgs,
 }

src/registry/mod.rs

@@ -158,8 +158,8 @@ pub fn semconv_registry(log: impl Logger + Sync + Clone, command: &RegistryComma
     }
 }
 
-/// Set of Parameters used to specify the extra options for the `weaver` command.
-/// The CommonRegistryArgs will be shared across all commands. So only the general options should be
+/// Set of Parameters used to specify the extra options for the `weaver registry` command.
+/// The CommonRegistryArgs will be shared across all `weaver registry` sub-commands. So only the general options should be
 /// included here.
 #[derive(Args, Debug)]
 pub struct CommonRegistryArgs {

src/registry/resolve.rs

@@ -57,7 +57,7 @@ pub struct RegistryResolveArgs {
     #[command(flatten)]
     pub diagnostic: DiagnosticArgs,
 
-    // Weaver parameters
+    // Common weaver registry parameters
     #[command(flatten)]
     pub common_registry_args: CommonRegistryArgs,
 }

src/registry/search.rs

@@ -53,7 +53,7 @@ pub struct RegistrySearchArgs {
     /// Otherwise, runs an interactive terminal UI.
     pub search_string: Option<String>,
 
-    /// Weaver parameters
+    /// Common weaver registry parameters
     #[command(flatten)]
     pub common_registry_args: CommonRegistryArgs,
 }

src/registry/stats.rs

@@ -26,7 +26,7 @@ pub struct RegistryStatsArgs {
     #[command(flatten)]
     pub diagnostic: DiagnosticArgs,
 
-    /// Weaver parameters
+    /// Common weaver registry parameters
     #[command(flatten)]
     pub common_registry_args: CommonRegistryArgs,
 }

src/registry/update_markdown.rs

@@ -50,7 +50,7 @@ pub struct RegistryUpdateMarkdownArgs {
     #[command(flatten)]
     pub diagnostic: DiagnosticArgs,
 
-    /// Weaver parameters
+    /// Common weaver registry parameters
     #[command(flatten)]
     pub common_registry_args: CommonRegistryArgs,
 }