Merge pull request #1288 from doradocodes/1142-2.0b

doradocodes · web-flow · commit 82640022ea97 · 2026-03-30T12:28:06.000-04:00
Merge PR #1142 to 2.0 branch
diff --git a/src/content/tutorials/config.ts b/src/content/tutorials/config.ts
@@ -19,19 +19,39 @@ export const categories = [
 export const tutorialsCollection = defineCollection({
   type: "content",
   schema: ({ image }) =>
-    z.object({
-      // Title of the tutorial
-      title: z.string(),
-      // People who wrote the tutorial
-      authors: z.array(z.string()).optional(),
-      // Optional note explaining more context about the authors
-      authorsNote: z.string().optional(),
-      description: z.string().optional(),
-      category: z.enum(categories),
-      categoryIndex: z.number().optional(),
-      // Image to use as a thumbnail for the tutorial
-      featuredImage: image().optional(),
-      featuredImageAlt: z.string().optional(),
-      relatedContent: relatedContent().optional(),
-    }),
+    z
+      .object({
+        // Title of the tutorial
+        title: z.string(),
+        // People who wrote the tutorial
+        authors: z.array(z.string()).optional(),
+        // Optional note explaining more context about the authors
+        authorsNote: z.string().optional(),
+        description: z.string().optional(),
+        category: z.enum(categories),
+        categoryIndex: z.number().optional(),
+        // Image to use as a thumbnail for the tutorial
+        featuredImage: image().optional(),
+        featuredImageAlt: z.string().optional(),
+        relatedContent: relatedContent().optional(),
+      })
+      .refine(
+        (data) => {
+          // Allow missing fields during development for quicker iteration
+          if (import.meta.env.DEV) return true;
+          return (
+            data.authors !== undefined &&
+            data.authors.length > 0 &&
+            data.featuredImage !== undefined &&
+            data.featuredImageAlt !== undefined &&
+            data.featuredImageAlt.trim().length > 0 &&
+            data.description !== undefined &&
+            data.description.trim().length > 0
+          );
+        },
+        {
+          message:
+            "Tutorials must include authors, featuredImage, featuredImageAlt, and description for production builds",
+        },
+      ),
 });
diff --git a/src/layouts/TutorialLayout.astro b/src/layouts/TutorialLayout.astro
@@ -50,8 +50,8 @@ const relatedExamples =
 <Head
   title={entry.data.title}
   locale={currentLocale}
-  description={entry.data.authors.join(", ")}
-  featuredImageSrc={entry.data.featuredImage.src}
+  description={entry.data.authors?.join(", ")}
+  featuredImageSrc={entry.data.featuredImage?.src}
 />
 
 <BaseLayout
@@ -62,7 +62,7 @@ const relatedExamples =
   topic="tutorials"
   className="tutorials"
 >
-  {entry.data.authors && <h6>By {entry.data.authors.join(", ")}</h6>}
+  {entry.data.authors && <section role="group" aria-label="authors">By {entry.data.authors?.join(", ")}</section>}
   {entry.data.authorsNote && <h7>{entry.data.authorsNote}</h7>}
   <div class="rendered-markdown">
     <Content
