Introduce blog section and add post about LLM provider quirks

docs-site/scripts/check-links.py

@@ -46,12 +46,17 @@
 # Each URL must be listed explicitly — new links to the same domain will
 # error until added here, so broken links don't slip through unnoticed.
 SKIPPED_URLS: set[str] = {
+    "https://ai.google.dev/gemini-api/docs/gemini-3",
+    "https://ai.google.dev/gemini-api/docs/structured-output",
+    "https://arxiv.org/abs/2506.21558",
     "https://clinicaltrials.gov/",
     "https://clinicaltrials.gov/data-api/about-api",
     "https://code.claude.com/docs/en/discover-plugins",
     "https://code.claude.com/docs/en/mcp",
     "https://cursor.com/deeplink/mcp-install-dark.svg",
     "https://cursor.com/docs/context/skills",
+    "https://developers.openai.com/api/docs/guides/structured-outputs/",
+    "https://developers.openai.com/api/reference/resources/responses/methods/create",
     "https://developers.openai.com/codex/mcp/",
     "https://developers.openai.com/codex/skills",
     "https://docs.astral.sh/uv/",
@@ -68,9 +73,9 @@
     "https://hugovk.github.io/top-pypi-packages/",
     "https://jqlang.org/",
     "https://pip.pypa.io/en/stable/",
+    "https://platform.claude.com/docs/en/build-with-claude/extended-thinking",
     "https://www.kaggle.com/code/rafaelpoyiadzi/active-learning-with-an-llm-oracle",
     "https://www.kaggle.com/datasets/tunguz/pubmed-title-abstracts-2019-baseline",
-    "https://arxiv.org/abs/2506.21558",
 }
 
 

docs-site/src/app/blog/[slug]/page.tsx

@@ -0,0 +1,62 @@
+import { notFound } from "next/navigation";
+import { DocsLayout } from "@/components/DocsLayout";
+import { MDXContent } from "@/components/MDXContent";
+import { getNavigation } from "@/utils/docs";
+import { getBlogPostBySlug, getBlogPostSlugs, formatDate } from "@/utils/blog";
+
+interface PageProps {
+  params: Promise<{ slug: string }>;
+}
+
+export async function generateStaticParams() {
+  const slugs = getBlogPostSlugs();
+  return slugs.map((slug) => ({ slug }));
+}
+
+export async function generateMetadata({ params }: PageProps) {
+  const { slug } = await params;
+  const post = getBlogPostBySlug(slug);
+
+  if (!post) {
+    return { title: "Not Found" };
+  }
+
+  const canonicalUrl = `https://everyrow.io/docs/blog/${slug}`;
+
+  return {
+    title: post.title,
+    description: post.description,
+    alternates: { canonical: canonicalUrl },
+    openGraph: {
+      title: post.title,
+      description: post.description,
+      url: canonicalUrl,
+      images: [{ url: "https://everyrow.io/everyrow-og.png" }],
+    },
+  };
+}
+
+export default async function BlogPostPage({ params }: PageProps) {
+  const { slug } = await params;
+  const post = getBlogPostBySlug(slug);
+
+  if (!post) {
+    notFound();
+  }
+
+  const navigation = getNavigation();
+
+  return (
+    <DocsLayout navigation={navigation}>
+      <article className="blog-post">
+        <div className="blog-post-meta">
+          {post.date && <span>{formatDate(post.date)}</span>}
+          {post.authors.length > 0 && (
+            <span className="blog-post-author">{post.authors.join(", ")}</span>
+          )}
+        </div>
+        <MDXContent source={post.content} />
+      </article>
+    </DocsLayout>
+  );
+}

docs-site/src/app/blog/page.tsx

@@ -0,0 +1,53 @@
+import type { Metadata } from "next";
+import Link from "next/link";
+import { DocsLayout } from "@/components/DocsLayout";
+import { getNavigation } from "@/utils/docs";
+import { getAllBlogPosts, formatDate } from "@/utils/blog";
+
+export const metadata: Metadata = {
+  title: "Blog - Everyrow",
+  description:
+    "Technical blog posts from the everyrow team about LLMs, data processing, and building AI-powered infrastructure.",
+  alternates: {
+    canonical: "https://everyrow.io/docs/blog",
+  },
+  openGraph: {
+    title: "Blog - Everyrow",
+    description:
+      "Technical blog posts from the everyrow team about LLMs, data processing, and building AI-powered infrastructure.",
+    url: "https://everyrow.io/docs/blog",
+    images: [{ url: "https://everyrow.io/everyrow-og.png" }],
+  },
+};
+
+export default async function BlogPage() {
+  const navigation = getNavigation();
+  const posts = getAllBlogPosts();
+
+  return (
+    <DocsLayout navigation={navigation}>
+      <h1>Blog</h1>
+      <p className="blog-listing-subtitle">
+        Technical posts from the everyrow team.
+      </p>
+      <div className="blog-listing">
+        {posts.map((post) => (
+          <Link
+            key={post.slug}
+            href={`/blog/${post.slug}`}
+            className="blog-listing-card"
+          >
+            <div className="blog-listing-card-meta">
+              {post.date && <span>{formatDate(post.date)}</span>}
+              {post.authors.length > 0 && <span>{post.authors.join(", ")}</span>}
+            </div>
+            <h2 className="blog-listing-card-title">{post.title}</h2>
+            {post.description && (
+              <p className="blog-listing-card-description">{post.description}</p>
+            )}
+          </Link>
+        ))}
+      </div>
+    </DocsLayout>
+  );
+}

docs-site/src/app/globals.css

@@ -71,6 +71,11 @@ a:hover {
   opacity: 0.8;
 }
 
+.docs-sidebar-logo-chips {
+  display: flex;
+  gap: 0.375rem;
+}
+
 .docs-sidebar-logo-chip {
   font-family: var(--font-inter), -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
   font-size: 0.6875rem;
@@ -697,6 +702,76 @@ noscript + .installation-tabs .tab-content:first-child {
   display: none;
 }
 
+/* Blog styles */
+.blog-post-meta {
+  display: flex;
+  align-items: center;
+  gap: 0.75rem;
+  font-size: 0.875rem;
+  color: var(--muted);
+  margin-bottom: 0.25rem;
+}
+
+.blog-post-author::before {
+  content: "\00b7";
+  margin-right: 0.75rem;
+}
+
+.blog-listing-subtitle {
+  font-size: 1rem;
+  color: var(--muted);
+  margin-bottom: 2rem;
+}
+
+.blog-listing {
+  display: flex;
+  flex-direction: column;
+  gap: 1rem;
+}
+
+.blog-listing-card {
+  display: block;
+  padding: 1.25rem;
+  border: 1px solid var(--border);
+  border-radius: 0.75rem;
+  text-decoration: none;
+  color: inherit;
+  transition: border-color 0.15s;
+}
+
+.blog-listing-card:hover {
+  border-color: var(--accent);
+  text-decoration: none;
+}
+
+.blog-listing-card-meta {
+  display: flex;
+  align-items: center;
+  gap: 0.75rem;
+  font-size: 0.8rem;
+  color: var(--muted);
+  margin-bottom: 0.5rem;
+}
+
+.blog-listing-card-meta span::before {
+  content: "\00b7";
+  margin-right: 0.75rem;
+}
+
+.blog-listing-card-title {
+  font-size: 1.125rem;
+  font-weight: 600;
+  margin: 0 0 0.5rem;
+  color: var(--foreground);
+}
+
+.blog-listing-card-description {
+  font-size: 0.875rem;
+  color: var(--muted);
+  line-height: 1.5;
+  margin: 0;
+}
+
 /* Mobile responsive */
 @media (max-width: 768px) {
   /* Hide desktop elements on mobile */

docs-site/src/app/page.tsx

@@ -82,8 +82,7 @@ function SectionCard({ section }: { section: NavSection }) {
             <path d="M9 18h6" />
             <path d="M10 22h4" />
           </svg>
-        )}
-      </div>
+        )}      </div>
       <h2 className="landing-card-title">{section.title}</h2>
       <p className="landing-card-description">{description}</p>
       <div className="landing-card-count">

docs-site/src/app/sitemap.ts

@@ -1,6 +1,7 @@
 import { MetadataRoute } from "next";
 import { getDocSlugs } from "@/utils/docs";
 import { getNotebookSlugs } from "@/utils/notebooks";
+import { getBlogPostSlugs } from "@/utils/blog";
 
 export const dynamic = "force-static";
 
@@ -9,8 +10,9 @@ export default function sitemap(): MetadataRoute.Sitemap {
 
   const docSlugs = getDocSlugs();
   const notebookSlugs = getNotebookSlugs();
+  const blogSlugs = getBlogPostSlugs();
 
-  const hubSlugs = new Set(["guides", "case-studies", "api"]);
+  const hubSlugs = new Set(["guides", "case-studies", "api", "blog"]);
 
   const docPages = docSlugs.map((slug) => ({
     url: `${baseUrl}/${slug}`,
@@ -26,6 +28,13 @@ export default function sitemap(): MetadataRoute.Sitemap {
     priority: 0.7,
   }));
 
+  const blogPages = blogSlugs.map((slug) => ({
+    url: `${baseUrl}/blog/${slug}`,
+    lastModified: new Date(),
+    changeFrequency: "monthly" as const,
+    priority: 0.7,
+  }));
+
   return [
     {
       url: baseUrl,
@@ -35,5 +44,6 @@ export default function sitemap(): MetadataRoute.Sitemap {
     },
     ...docPages,
     ...notebookPages,
+    ...blogPages,
   ];
 }