---
// src/content/config.ts
import { defineCollection, z } from 'astro:content';

const docs = defineCollection({
  type: 'content',
  schema: z.object({
    title: z.string(),
    order: z.number(),
  }),
});

export const collections = { docs };

<!-- src/content/docs/getting-started.md -->
---
title: Getting Started
order: 1
---

Content for the first doc page.

<!-- src/content/docs/configuration.md -->
---
title: Configuration
order: 2
---

Content for the second doc page.

<!-- src/content/docs/deployment.md -->
---
title: Deployment
order: 3
---

Content for the third doc page.

<!-- src/pages/docs/index.astro -->
---
import { getCollection } from 'astro:content';

const entries = (await getCollection('docs')).sort(
  (a, b) => a.data.order - b.data.order
);
---

<ul>
  {entries.map((entry) => <li>{entry.data.title}</li>)}
</ul>

<!--
  Notes:
  - Each content file's frontmatter is validated against the docs
    schema the moment the dev server or build reads it.
  - getCollection('docs') returns entries in no guaranteed order, so
    sorting by data.order explicitly in the page itself is required.
-->