From af873f27c7f4ef404cdef995733f48e95a506748 Mon Sep 17 00:00:00 2001
From: Daniel Riazanovskiy <daniel.riazanovskiy@sourcegraph.com>
Date: Mon, 17 Nov 2025 18:20:28 +0300
Subject: [PATCH] Lookup Pretty Breadcrumbs In Page Titles

---
 src/components/Breadcrumbs.tsx | 34 +++++++++++++++++++++++++++++++++-
 1 file changed, 33 insertions(+), 1 deletion(-)

diff --git a/src/components/Breadcrumbs.tsx b/src/components/Breadcrumbs.tsx
index 83012438e..58c03061c 100644
--- a/src/components/Breadcrumbs.tsx
+++ b/src/components/Breadcrumbs.tsx
@@ -5,6 +5,8 @@ import clsx from 'clsx';
 import {ChevronRightIcon} from '@heroicons/react/20/solid';
 import {useEffect, useState} from 'react';
 import {usePathname} from 'next/navigation';
+import {navigation} from '@/data/navigation';
+import {allPosts} from 'contentlayer/generated';
 
 export function Breadcrumbs({path}: {path: string[]}) {
 	let pathname = usePathname();
@@ -23,6 +25,36 @@ export function Breadcrumbs({path}: {path: string[]}) {
 		return version ? `/v/${version}${path}` : path;
 	};
 
+	const getTitleForSlug = (currentPath: string[]): string => {
+		const href = `/${currentPath.join('/')}`;
+
+		for (const navItem of navigation) {
+			for (const topic of navItem.topics) {
+				if (topic.href === href) return topic.title;
+
+				if (topic.sections) {
+					for (const section of topic.sections) {
+						if (section.href === href) return section.title;
+
+						if (section.subsections) {
+							for (const subsection of section.subsections) {
+								if (subsection.href === href) return subsection.title;
+							}
+						}
+					}
+				}
+			}
+		}
+
+		const pagePath = currentPath.join('/');
+		const post = allPosts.find(post => post._raw.flattenedPath === pagePath);
+		if (post && post.headings && post.headings.length > 0) {
+			return post.headings[0].title;
+		}
+
+		throw new Error(`No title found in navigation.ts or page headings for path: ${href}`);
+	};
+
 	// Handle versions
 	useEffect(() => {
 		// Extract the version name from the URL path, if any
@@ -67,7 +99,7 @@ export function Breadcrumbs({path}: {path: string[]}) {
 										: 'text-gray-500 hover:text-link-light dark:hover:text-link'
 								)}
 							>
-								{slug}
+								{getTitleForSlug(path.slice(0, index + 1))}
 							</Link>
 						</div>
 					</li>