···1+---
2+title: Example Guide
3+description: A guide in my new Starlight docs site.
4+---
5+6+<!--
7+SPDX-FileCopyrightText: 2025 Ruby Iris Juric <ruby@srxl.me>
8+9+SPDX-License-Identifier: 0BSD
10+-->
11+12+Guides lead a user through a specific task they want to accomplish, often with a sequence of steps.
13+Writing a good guide requires thinking about what your users are trying to do.
14+15+## Further reading
16+17+- Read [about how-to guides](https://diataxis.fr/how-to-guides/) in the Diátaxis framework
+37
docs/src/content/docs/index.mdx
···0000000000000000000000000000000000000
···1+---
2+title: Welcome to Starlight
3+description: Get started building your docs site with Starlight.
4+template: splash
5+hero:
6+ tagline: Congrats on setting up a new Starlight project!
7+ actions:
8+ - text: Example Guide
9+ link: /guides/example/
10+ icon: right-arrow
11+ - text: Read the Starlight docs
12+ link: https://starlight.astro.build
13+ icon: external
14+ variant: minimal
15+---
16+17+{/* SPDX-FileCopyrightText: 2025 Ruby Iris Juric <ruby@srxl.me> */}
18+{/* SPDX-License-Identifier: 0BSD */}
19+20+import { Card, CardGrid } from "@astrojs/starlight/components";
21+22+## Next steps
23+24+<CardGrid stagger>
25+ <Card title="Update content" icon="pencil">
26+ Edit `src/content/docs/index.mdx` to see this page change.
27+ </Card>
28+ <Card title="Add new content" icon="add-document">
29+ Add Markdown or MDX files to `src/content/docs` to create new pages.
30+ </Card>
31+ <Card title="Configure your site" icon="setting">
32+ Edit your `sidebar` and other config in `astro.config.mjs`.
33+ </Card>
34+ <Card title="Read the docs" icon="open-book">
35+ Learn more in [the Starlight Docs](https://starlight.astro.build/).
36+ </Card>
37+</CardGrid>
+17
docs/src/content/docs/reference/example.md
···00000000000000000
···1+---
2+title: Example Reference
3+description: A reference page in my new Starlight docs site.
4+---
5+6+<!--
7+SPDX-FileCopyrightText: 2025 Ruby Iris Juric <ruby@srxl.me>
8+9+SPDX-License-Identifier: 0BSD
10+-->
11+12+Reference pages are ideal for outlining how things work in terse and clear terms.
13+Less concerned with telling a story or addressing a specific use case, they should give a comprehensive outline of what you're documenting.
14+15+## Further reading
16+17+- Read [about reference](https://diataxis.fr/reference/) in the Diátaxis framework