Getting Started

Welcome to Draconis Engineering. All docs are Markdown/MDX — edit in src/content/docs/ and push, GitHub Actions rebuilds the site.

Install

# example — replace with your real package
git clone https://github.com/draconis-engineering/olympus
cd olympus
npm install

Structure

• src/content/docs/ — this folder. Each .mdx is a page.
• src/content/blog/ — engineering journal posts.
• astro.config.mjs:site → https://draconis-engineering.com

Add a file like src/content/docs/olympus/api.mdx and it appears at /docs/olympus/api automatically.

Writing docs

Frontmatter controls the sidebar:

---
title: "My New Page"
description: "Short blurb for listings"
order: 2
tag: "OLYMPUS"
---

Use normal Markdown, plus components. Prose is styled in the layout.

Next: see Architecture