Fix broken links, correct GitHub URLs, and flesh out docs

- Fix card links on Dragonfly and Jetpack intro pages (replace
  non-existent "production deployment" paths with real targets
  or about:blank for unimplemented features)
- Correct GitHub org from dragonflycomputer to riffcc in
  installation pages
- Rewrite docs index with proper feature cards and links
- Add component descriptions for Mage, Spark, and Jetpack
- Fix Mage page (was copy-pasted Spark description)
- Expand perform-maintenance guide with Spark advanced menu
- Mention Mage and Jetpack in introduction alongside Spark

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: Zorlin

content/docs/_index.md

@@ -11,26 +11,24 @@ Welcome to Dragonfly.
 
 Dragonfly is a powerful *metal management* platform that simplifies the deployment and management of operating systems and software across your infrastructure.
 
-It consists of two main components: Dragonfly and Jetpack.
-
 <hr>
 {{< hextra/feature-grid >}}
+    {{< hextra/feature-card
+    title="Learn more"
+    subtitle="Get to know Dragonfly. Deploy operating systems across your infrastructure with ease."
+    link="/docs/introduction/dragonfly/"
+    icon="arrow-circle-right"
+    >}}
     {{< hextra/feature-card
     title="Quick Start"
-    subtitle="Bare metal provisioning and PXE boot management. Deploy operating systems across your infrastructure with ease."
-    link="quick-start"
-    icon="server"
+    subtitle="Get started with Dragonfly in minutes. Guides for Linux, macOS and Docker."
+    link="/docs/installation/quick-start/"
+    icon="cloud-download"
+    >}}
+    {{< hextra/feature-card
+        title="Docker & Kubernetes"
+        subtitle="Instructions for installing and deploying Dragonfly on Docker or Kubernetes."
+        link="/docs/installation/"
+        icon="trending-up"
     >}}
-  {{< hextra/feature-card
-    title="Install"
-    subtitle="Bare metal provisioning and PXE boot management. Deploy operating systems across your infrastructure with ease."
-    link="dragonfly"
-    icon="server"
-  >}}
-  {{< hextra/feature-card
-    title="Docker & Kubernetes"
-    subtitle="Instructions for installing and deploying Dragonfly on Docker or Kubernetes."
-    link="jetpack"
-    icon="chip"
-  >}}
 {{< /hextra/feature-grid >}}

content/docs/components/_index.md

@@ -6,4 +6,25 @@ weight: 7
 sidebar:
     open: true
 ---
-Spark documentation coming soon.
+
+Dragonfly consists of various vertically integrated open source tools. 
+
+<p></p>
+{{< hextra/feature-grid >}}
+  {{< hextra/feature-card
+    title="Jetpack"
+    subtitle="Next-generation configuration management. A modern approach to infrastructure automation that learns from Ansible's lessons."
+    link="/docs/introduction/jetpack/"
+    icon="chip"
+  >}}
+  {{< hextra/feature-card
+    title="Mage"
+    subtitle="Our operating system flashing framework. Images machines in under 90 seconds."
+    icon="status-online"
+  >}}
+  {{< hextra/feature-card
+    title="Spark"
+    subtitle="Allows for remote management of devices and machines, including provisioning, monitoring, and troubleshooting."
+    icon="lightning-bolt"
+  >}}
+{{< /hextra/feature-grid >}}

content/docs/components/mage.md

@@ -6,6 +6,8 @@ weight: 1
 sidebar:
     open: true
 ---
-Spark is a powerful PXE boot agent that allows you to enable remote management of your entire network.
+Mage is our custom imaging agent.
 
-You can enable Spark on a machine by simply enabling boot-to-network as your default boot option on any machine on a network with a running Dragonfly deployment.
+It consists of a small Rust binary called `dragonfly-agent` and wrappers around Alpine Linux.
+
+More information coming soon in Dragonfly v0.2.0.

content/docs/components/spark.md

@@ -9,3 +9,5 @@ sidebar:
 Spark is a powerful PXE boot agent that allows you to enable remote management of your entire network.
 
 You can enable Spark on a machine by simply enabling boot-to-network as your default boot option on any machine on a network with a running Dragonfly deployment.
+
+More information coming soon in Dragonfly v0.2.0.

content/docs/installation/_index.md

@@ -36,4 +36,6 @@ As soon as Dragonfly is up and running, you can use it to manage your computers.
 
 The Spark agent allows you to perform basic maintenance tasks remotely or locally.
 
+Enable PXE/Network booting on each computer you want to manage with Spark.
+
 {{% /steps %}}

content/docs/installation/native.md

@@ -7,7 +7,7 @@ sidebar:
     open: true
 next: /docs/installation/production-setup/
 ---
-Download the latest binary from the [releases page](https://github.com/dragonflycomputer/dragonfly/releases).
+Download the latest binary from the [releases page](https://github.com/riffcc/dragonfly/releases).
 
 You'll want the version for your computer.
 
@@ -16,7 +16,7 @@ You'll want the version for your computer.
   {{< tab >}}
   Download Dragonfly from the [releases page](https://github.com/riffcc/dragonfly/releases).
   ```
-  wget -O dragonfly https://github.com/dragonflycomputer/dragonfly/releases/download/v0.1.0-alpha1/dragonfly-linux-amd64
+  wget -O dragonfly https://github.com/riffcc/dragonfly/releases/download/v0.1.0-alpha1/dragonfly-linux-amd64
   ```
 
   Copy the binary to /usr/local/bin/dragonfly and make it executable:
@@ -37,7 +37,7 @@ You'll want the version for your computer.
   {{< tab >}}
   Download Dragonfly from the [releases page](https://github.com/riffcc/dragonfly/releases).
   ```
-  wget -O dragonfly https://github.com/dragonflycomputer/dragonfly/releases/download/v0.1.0-alpha1/dragonfly-darwin-amd64
+  wget -O dragonfly https://github.com/riffcc/dragonfly/releases/download/v0.1.0-alpha1/dragonfly-darwin-amd64
   ```
 
   Copy the binary to /usr/local/bin/dragonfly and make it executable:

content/docs/installation/quick-start.md

@@ -31,13 +31,13 @@ Edit it to your needs, then run
 docker-compose up -d
 ```
 
-Visit the web interface at http://localhost:3000
+Visit the web interface at `http://localhost:3000`
 (or `http://your-hostname:3000` if you're not running it locally)
 
-For more details on running Dragonfly with Docker, see the [Docker guide](/docs/docker).
+For more details on running Dragonfly with Docker, see the [Docker guide](/docs/installation/docker).
 
 ### Binary Installation
-Download the latest binary from the [releases page](https://github.com/dragonflycomputer/dragonfly/releases).
+Download the latest binary from the [releases page](https://github.com/riffcc/dragonfly/releases).
 
 You'll want the version for your computer.
 
@@ -46,7 +46,7 @@ You'll want the version for your computer.
   {{< tab >}}
   Download Dragonfly from the [releases page](https://github.com/riffcc/dragonfly/releases).
   ```
-  wget -O dragonfly https://github.com/dragonflycomputer/dragonfly/releases/download/v0.1.0-alpha1/dragonfly-linux-amd64
+  wget -O dragonfly https://github.com/riffcc/dragonfly/releases/download/v0.1.0-alpha1/dragonfly-linux-amd64
   ```
 
   Copy the binary to /usr/local/bin/dragonfly and make it executable:
@@ -65,9 +65,12 @@ You'll want the version for your computer.
   {{< /tab >}}
   <!-- macOS -->
   {{< tab >}}
+  macOS installation relies on installing Dragonfly as a native binary. 
+  Future releases will include Homebrew support.
+  
   Download Dragonfly from the [releases page](https://github.com/riffcc/dragonfly/releases).
   ```
-  wget -O dragonfly https://github.com/dragonflycomputer/dragonfly/releases/download/v0.1.0-alpha1/dragonfly-darwin-amd64
+  wget -O dragonfly https://github.com/riffcc/dragonfly/releases/download/v0.1.0-alpha1/dragonfly-darwin-amd64
   ```
 
   Copy the binary to /usr/local/bin/dragonfly and make it executable:

content/docs/introduction/_index.md

@@ -17,4 +17,4 @@ This means you can take a computer out of the box, network boot it, and be runni
 
 <img src="/images/screenshots/spark-install-os.png" alt="Dragonfly Machines Dashboard" style="width: 75%; border-radius: 0.5rem; box-shadow: 0 20px 25px -5px rgb(0 0 0 / 0.1), 0 8px 10px -6px rgb(0 0 0 / 0.1);" />
 
-Dragonfly also provides [Spark](/docs/components/spark/), a lightweight, distributed agent that can optionally be used to manage your computers and perform monitoring and management tasks.
+Dragonfly also provides [Spark](/docs/components/spark/), a lightweight, distributed agent that can optionally be used to manage your computers and perform monitoring and management tasks; [Mage](/docs/components/mage/) for flashing operating systems; and [Jetpack](/docs/introduction/jetpack/), an Infrastructure as Code tool for managing arbitrary infrastructure.

content/docs/introduction/dragonfly.md

@@ -16,14 +16,14 @@ You can use Dragonfly to install and manage Linux, as well as remotely reinstall
 {{< cards >}}
   {{< card link="/docs/usage/deploying-with-dragonfly" title="Deploy Linux in under 90 seconds" subtitle="Dragonfly deploys - fast. Bring up a machine all the way to SSH in 90 seconds or less."icon="hard-drive-download" >}}
   {{< card link="/docs/usage-jetpack/apply-updates" title="Apply updates across your fleet" subtitle="Keep your fleet up to date with automatic updates and security patches (coming soon)." icon="shield-check" >}}
-  {{< card link="production deployment" title="Perform maintenance tasks" subtitle="Remotely reinstall, wipe, diagnose, and repair - even on machines lacking IPMI/BMC devices." icon="hammer" >}}
-  {{< card link="production deployment" title="Boot to ISO" subtitle="Remotely reinstall, wipe, diagnose, and repair - even on machines lacking IPMI/BMC devices." icon="disc-2" >}}
-  {{< card link="production deployment" title="Manage from anywhere" subtitle="Designed for secure management from anywhere, Dragonfly gives you freedom and flexibility." icon="globe" >}}
-  {{< card link="dhcp" title="Coexists with existing infrastructure" subtitle="Dragonfly can coexist with existing DHCP servers, ensuring easy rollout and configuration." icon="handshake" >}}
+  {{< card link="/docs/usage/perform-maintenance/" title="Perform maintenance tasks" subtitle="Remotely reinstall, wipe, diagnose, and repair - even on machines lacking IPMI/BMC devices." icon="hammer" >}}
+  {{< card link="/docs/usage/managing-iso-images/" title="Boot to ISO" subtitle="Remotely reinstall, wipe, diagnose, and repair - even on machines lacking IPMI/BMC devices." icon="disc-2" >}}
+  {{< card link="about:blank" title="Manage from anywhere" subtitle="Designed for secure management from anywhere, Dragonfly gives you freedom and flexibility." icon="globe" >}}
+  {{< card link="about:blank" title="Coexists with existing infrastructure" subtitle="Dragonfly can coexist with existing DHCP servers, ensuring easy rollout and configuration." icon="handshake" >}}
   <!--
   {{< card link="multi region deployment" title="Multi-region deployment" icon="earth" >}}
   -->
-  {{< card link="kubernetes" title="Flexible deployment options" subtitle="Designed to run on everything from your laptop to entire data centers" icon="kubernetes" >}}
-  {{< card link="production deployment" title="Rich power controls" subtitle="Integrates with your favourite IPMI/BMC solutions - and Home Assistant and Proxmox (coming soon)" icon="power" >}}
-  {{< card link="multitenancy" title="Multi-tenancy" subtitle="Dragonfly supports multi-tenancy, allowing you to manage multiple environments from a single instance." icon="users" >}}
+  {{< card link="/docs/installation/" title="Flexible deployment options" subtitle="Designed to run on everything from your laptop to entire data centers" icon="kubernetes" >}}
+  {{< card link="about:blank" title="Rich power controls" subtitle="Integrates with your favourite IPMI/BMC solutions - and Home Assistant and Proxmox (coming soon)" icon="power" >}}
+  {{< card link="about:blank" title="Multi-tenancy" subtitle="Dragonfly supports multi-tenancy, allowing you to manage multiple environments from a single instance." icon="users" >}}
 {{< /cards >}}

content/docs/introduction/jetpack.md

@@ -15,10 +15,10 @@ It combines functionality seen in tools such as Ansible and Terraform, providing
 Jetpack is based on the Jetporch project by Jetporch contributors including Michael DeHaan.
 
 {{< cards >}}
-  {{< card link="powerful" title="Powerful and flexible" subtitle="Jetpack comes with all of the scripting capabilities you expect, including some you might not." icon="biceps-flexed" >}}
-  {{< card link="update" title="AI Native" subtitle="Built-in optional AI capabilities and integrations allow you to automate and optimize your infrastructure." icon="bot" >}}
+  {{< card link="about:blank" title="Powerful and flexible" subtitle="Jetpack comes with all of the scripting capabilities you expect, including some you might not." icon="biceps-flexed" >}}
+  {{< card link="about:blank" title="AI Native" subtitle="Built-in optional AI capabilities and integrations allow you to automate and optimize your infrastructure." icon="bot" >}}
   {{< card link="https://github.com/riffcc/jetpack" title="Open source" subtitle="Jetpack is open source and licensed under the GNU GPLv3." icon="copyleft" >}}
-  {{< card link="production deployment" title="Instantiate" subtitle="Need to deploy a database cluster? Jetpack will create the necessary infrastructure for you." icon="bow-arrow" >}}
-  {{< card link="production deployment" title="Rollback (coming soon)" subtitle="Undo rollouts and changes quickly." icon="undo-dot" >}}
-  {{< card link="production deployment" title="Fast" subtitle="Built for speed and scale, Jetpack is designed to handle large-scale deployments quickly and efficiently." icon="rabbit" >}}
+  {{< card link="about:blank" title="Instantiate" subtitle="Need to deploy a database cluster? Jetpack will create the necessary infrastructure for you." icon="bow-arrow" >}}
+  {{< card link="about:blank" title="Rollback (coming soon)" subtitle="Undo rollouts and changes quickly." icon="undo-dot" >}}
+  {{< card link="about:blank" title="Fast" subtitle="Built for speed and scale, Jetpack is designed to handle large-scale deployments quickly and efficiently." icon="rabbit" >}}
 {{< /cards >}}