···11+---
22+title: Example Guide
33+description: A guide in my new Starlight docs site.
44+---
55+66+<!--
77+SPDX-FileCopyrightText: 2025 Ruby Iris Juric <ruby@srxl.me>
88+99+SPDX-License-Identifier: 0BSD
1010+-->
1111+1212+Guides lead a user through a specific task they want to accomplish, often with a sequence of steps.
1313+Writing a good guide requires thinking about what your users are trying to do.
1414+1515+## Further reading
1616+1717+- Read [about how-to guides](https://diataxis.fr/how-to-guides/) in the Diátaxis framework
+37
docs/src/content/docs/index.mdx
···11+---
22+title: Welcome to Starlight
33+description: Get started building your docs site with Starlight.
44+template: splash
55+hero:
66+ tagline: Congrats on setting up a new Starlight project!
77+ actions:
88+ - text: Example Guide
99+ link: /guides/example/
1010+ icon: right-arrow
1111+ - text: Read the Starlight docs
1212+ link: https://starlight.astro.build
1313+ icon: external
1414+ variant: minimal
1515+---
1616+1717+{/* SPDX-FileCopyrightText: 2025 Ruby Iris Juric <ruby@srxl.me> */}
1818+{/* SPDX-License-Identifier: 0BSD */}
1919+2020+import { Card, CardGrid } from "@astrojs/starlight/components";
2121+2222+## Next steps
2323+2424+<CardGrid stagger>
2525+ <Card title="Update content" icon="pencil">
2626+ Edit `src/content/docs/index.mdx` to see this page change.
2727+ </Card>
2828+ <Card title="Add new content" icon="add-document">
2929+ Add Markdown or MDX files to `src/content/docs` to create new pages.
3030+ </Card>
3131+ <Card title="Configure your site" icon="setting">
3232+ Edit your `sidebar` and other config in `astro.config.mjs`.
3333+ </Card>
3434+ <Card title="Read the docs" icon="open-book">
3535+ Learn more in [the Starlight Docs](https://starlight.astro.build/).
3636+ </Card>
3737+</CardGrid>
+17
docs/src/content/docs/reference/example.md
···11+---
22+title: Example Reference
33+description: A reference page in my new Starlight docs site.
44+---
55+66+<!--
77+SPDX-FileCopyrightText: 2025 Ruby Iris Juric <ruby@srxl.me>
88+99+SPDX-License-Identifier: 0BSD
1010+-->
1111+1212+Reference pages are ideal for outlining how things work in terse and clear terms.
1313+Less concerned with telling a story or addressing a specific use case, they should give a comprehensive outline of what you're documenting.
1414+1515+## Further reading
1616+1717+- Read [about reference](https://diataxis.fr/reference/) in the Diátaxis framework