From 2bc69a6fc2a0dde40e357fbf43c71c549a995915 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Bartek=20Iwa=C5=84czuk?= Date: Mon, 15 Jun 2026 22:44:11 +0200 Subject: [PATCH 1/3] docs: add a Start here path and tag cookbook categories Add a short, ordered 'New to Deno? Start here' strip at the top of the examples landing page so newcomers have an obvious entry path, and tag the reference-style snippet categories (File system, System, Web standard APIs, Encoding) with a small Reference label so they read as a cookbook rather than tutorial-grade guides. Both are data-driven in _data.ts. --- _components/LandingPage.tsx | 34 ++++++++++++++++++++++++++- examples/_components/LearningList.tsx | 9 ++++++- examples/_data.ts | 27 +++++++++++++++++++++ 3 files changed, 68 insertions(+), 2 deletions(-) diff --git a/_components/LandingPage.tsx b/_components/LandingPage.tsx index 2a6cdae10..022e1d454 100644 --- a/_components/LandingPage.tsx +++ b/_components/LandingPage.tsx @@ -5,7 +5,12 @@ import { } from "../examples/_components/LearningList.tsx"; import { TutorialIcon } from "../examples/_components/TutorialIcon.tsx"; import { VideoIcon } from "../examples/_components/VideoIcon.tsx"; -import { featuredItems, sidebar } from "../examples/_data.ts"; +import { + cookbookCategories, + featuredItems, + sidebar, + startHere, +} from "../examples/_data.ts"; function FeaturedStar() { return ( @@ -38,6 +43,7 @@ export default function LandingPage( title={item.title} items={item.items} descriptions={descriptions} + isReference={cookbookCategories.includes(item.title)} /> ); }, @@ -98,6 +104,32 @@ export default function LandingPage( +
+

+ New to Deno? Start here +

+
    + {startHere.map((item, i) => ( +
  1. + + + + {item.title} + + +
    2. + ))} +
+
+

Featured

diff --git a/examples/_components/LearningList.tsx b/examples/_components/LearningList.tsx index 520545c8c..d38970d6d 100644 --- a/examples/_components/LearningList.tsx +++ b/examples/_components/LearningList.tsx @@ -19,13 +19,20 @@ export function LearningList( title: string; items: SidebarItem[]; descriptions?: Record; + isReference?: boolean; }, ) { const anchor = props.title.toLowerCase().replace(/\s+/g, "-"); return (

- {props.title}  + {props.title} + {props.isReference && ( + + Reference + + )} +   Jump to heading diff --git a/examples/_data.ts b/examples/_data.ts index 3bb3859a1..198b246cc 100644 --- a/examples/_data.ts +++ b/examples/_data.ts @@ -2067,5 +2067,32 @@ export const featuredItems = [ }, ]; +// A short, ordered path for people new to Deno, rendered as a numbered strip +// at the top of the landing page. +export const startHere = [ + { title: "Run a script", href: "/examples/run_script_tutorial/" }, + { title: "Hello World", href: "/examples/hello_world/" }, + { + title: "Built in TypeScript support", + href: "/examples/typescript_support/", + }, + { + title: "Initialize a project", + href: "/examples/initialize_project_tutorial/", + }, + { title: "Simple API server", href: "/examples/simple_api_tutorial/" }, + { title: "Writing tests", href: "/examples/writing_tests/" }, +]; + +// Categories that are copy-paste reference snippets rather than +// walkthrough-style guides. The landing page tags these as "Reference" so +// newcomers can tell them apart from tutorial-grade content. +export const cookbookCategories = [ + "File system", + "System", + "Web standard APIs", + "Encoding", +]; + export const sectionTitle = "Examples"; export const sectionHref = "/examples/"; From 2a6cac63bb0267442df31d931234e9015a13984a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Bartek=20Iwa=C5=84czuk?= Date: Mon, 15 Jun 2026 22:52:11 +0200 Subject: [PATCH 2/3] chore: re-trigger CI From a2e2b4fe79db7eeac8342d03ad22a05b483e83d4 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Bartek=20Iwa=C5=84czuk?= Date: Wed, 17 Jun 2026 09:40:00 +0200 Subject: [PATCH 3/3] docs: drop the Start here strip, keep cookbook Reference tags The landing page already stacks Featured, a type-filter bar, and a category pill nav above the lists; a numbered Start here band on top overlapped with Featured and crowded the page. Keep the lightweight Reference category labels, which add signal without another band. --- _components/LandingPage.tsx | 27 --------------------------- examples/_data.ts | 17 ----------------- 2 files changed, 44 deletions(-) diff --git a/_components/LandingPage.tsx b/_components/LandingPage.tsx index 022e1d454..c9add24ea 100644 --- a/_components/LandingPage.tsx +++ b/_components/LandingPage.tsx @@ -9,7 +9,6 @@ import { cookbookCategories, featuredItems, sidebar, - startHere, } from "../examples/_data.ts"; function FeaturedStar() { @@ -104,32 +103,6 @@ export default function LandingPage( -
-

- New to Deno? Start here -

-
    - {startHere.map((item, i) => ( -
  1. - - - - {item.title} - - -
    2. - ))} -
-
-

Featured

diff --git a/examples/_data.ts b/examples/_data.ts index 198b246cc..911fb75c4 100644 --- a/examples/_data.ts +++ b/examples/_data.ts @@ -2067,23 +2067,6 @@ export const featuredItems = [ }, ]; -// A short, ordered path for people new to Deno, rendered as a numbered strip -// at the top of the landing page. -export const startHere = [ - { title: "Run a script", href: "/examples/run_script_tutorial/" }, - { title: "Hello World", href: "/examples/hello_world/" }, - { - title: "Built in TypeScript support", - href: "/examples/typescript_support/", - }, - { - title: "Initialize a project", - href: "/examples/initialize_project_tutorial/", - }, - { title: "Simple API server", href: "/examples/simple_api_tutorial/" }, - { title: "Writing tests", href: "/examples/writing_tests/" }, -]; - // Categories that are copy-paste reference snippets rather than // walkthrough-style guides. The landing page tags these as "Reference" so // newcomers can tell them apart from tutorial-grade content.