Skip nondocable crates

Author: Dirbaio

src/cmd/doc.rs

@@ -9,7 +9,7 @@ pub struct Args {
     /// Build docs for only these crates (must be publishable)
     #[clap(long = "crate")]
     pub crates: Vec<String>,
-    
+
     /// Output directory for generated documentation
     #[clap(short, long)]
     pub output: PathBuf,
@@ -20,7 +20,7 @@ pub fn run(ctx: &Context, args: Args) -> Result<()> {
         // Build docs for all publishable crates
         ctx.crates
             .iter()
-            .filter(|(_, crate_info)| crate_info.publish)
+            .filter(|(_, crate_info)| crate_info.publish && crate_info.doc)
             .map(|(crate_id, _)| crate_id.clone())
             .collect()
     } else {
@@ -31,6 +31,10 @@ pub fn run(ctx: &Context, args: Args) -> Result<()> {
                 anyhow::bail!("Crate '{}' not found", crate_name);
             }
             let crate_info = &ctx.crates[crate_name];
+            if !crate_info.doc {
+                println!("⚠️  Skipping non-documentable crate: {}", crate_name);
+                continue;
+            }
             if !crate_info.publish {
                 println!("⚠️  Skipping non-publishable crate: {}", crate_name);
                 continue;
@@ -53,30 +57,34 @@ pub fn run(ctx: &Context, args: Args) -> Result<()> {
         let crate_info = &ctx.crates[crate_id];
         let input_path = &crate_info.path;
         let output_path = args.output.join("crates").join(crate_id).join("git.zup");
-        
+
         println!("Building docs for crate: {}", crate_id);
-        
+
         let mut cmd = Command::new("docserver");
         cmd.arg("build")
             .arg("-i")
             .arg(input_path)
             .arg("-o")
             .arg(&output_path);
-        
+
         // Add --output-static for the first docserver invocation
         if is_first_invocation {
             let static_output = args.output.join("static");
             cmd.arg("--output-static").arg(&static_output);
             is_first_invocation = false;
         }
-        
+
         match cmd.status() {
             Ok(status) if status.success() => {
                 println!("✅ Successfully built docs for {}", crate_id);
                 success_count += 1;
             }
             Ok(status) => {
-                eprintln!("❌ Failed to build docs for {} (exit code: {:?})", crate_id, status.code());
+                eprintln!(
+                    "❌ Failed to build docs for {} (exit code: {:?})",
+                    crate_id,
+                    status.code()
+                );
                 failed_crates.push(crate_id.clone());
             }
             Err(e) => {
@@ -88,14 +96,17 @@ pub fn run(ctx: &Context, args: Args) -> Result<()> {
 
     println!("\nSummary:");
     println!("✅ Successfully built docs for {} crates", success_count);
-    
+
     if !failed_crates.is_empty() {
-        println!("❌ Failed to build docs for {} crates:", failed_crates.len());
+        println!(
+            "❌ Failed to build docs for {} crates:",
+            failed_crates.len()
+        );
         for crate_name in &failed_crates {
             println!("  - {}", crate_name);
         }
         anyhow::bail!("Failed to build docs for {} crates", failed_crates.len());
     }
 
     Ok(())
-}
+}

src/main.rs

@@ -98,6 +98,7 @@ fn list_crates(root: &PathBuf) -> Result<BTreeMap<CrateId, Crate>> {
                         build_dependencies,
                         configs,
                         publish: parsed.package.publish,
+                        doc: parsed.package.metadata.embassy_docs.is_some(),
                     },
                 );
             }

src/types.rs

@@ -32,6 +32,8 @@ fn default_publish() -> bool {
 pub struct Metadata {
     #[serde(default)]
     pub embassy: MetadataEmbassy,
+    #[serde(default)]
+    pub embassy_docs: Option<MetadataEmbassyDocs>,
 }
 
 #[allow(dead_code)]
@@ -43,6 +45,10 @@ pub struct MetadataEmbassy {
     pub build: Vec<BuildConfig>,
 }
 
+// used just to check for presence.
+#[derive(Debug, Deserialize, Default)]
+pub struct MetadataEmbassyDocs {}
+
 #[derive(Debug, Clone, Deserialize, Default)]
 pub struct BuildConfig {
     pub group: Option<String>,
@@ -69,6 +75,7 @@ pub struct Crate {
     pub dev_dependencies: Vec<CrateId>,
     pub configs: Vec<BuildConfig>,
     pub publish: bool,
+    pub doc: bool,
 }
 
 impl Crate {