Skip to content

Migrate docs from Hugo Docsy to Astro Starlight - #68

Merged
aswinnarayanan merged 1 commit into
mainfrom
migrate-to-starlight
Jun 22, 2026
Merged

aswinnarayanan merged 1 commit into
mainfrom
migrate-to-starlight

Conversation

@aswinnarayanan

Copy link
Copy Markdown
Collaborator
  • Port all content; convert Docsy shortcodes (alert/pageinfo/card) to Starlight asides and cards, and procedures to Steps
  • Reimplement the interactive email request forms as Astro components
  • Restructure for clarity:
    • Getting Started is one tabbed page by member type (UQ / Other AAF / Non-AAF), with explainer cards and shareable ?member= links
    • Logging into XNAT consolidated into a single AAF / RCC Authenticate page
    • Alias tokens moved to Processing Data (it is external-tool auth)
    • CTP Windows and Linux service pages merged into one OS-tabbed page
    • Scans folded into the Sessions overview
    • Empty section landings given an intro and card grid
  • UQ purple theme, restyled navbar search, cycling light/dark/auto toggle
  • Preserve every old Hugo /docs/... URL (and legacy aliases) via redirects
  • Build and deploy to GitHub Pages with Node 20 instead of Hugo

- Port all content; convert Docsy shortcodes (alert/pageinfo/card) to
  Starlight asides and cards, and procedures to Steps
- Reimplement the interactive email request forms as Astro components
- Restructure for clarity:
  - Getting Started is one tabbed page by member type (UQ / Other AAF /
    Non-AAF), with explainer cards and shareable ?member= links
  - Logging into XNAT consolidated into a single AAF / RCC Authenticate
page
  - Alias tokens moved to Processing Data (it is external-tool auth)
  - CTP Windows and Linux service pages merged into one OS-tabbed page
  - Scans folded into the Sessions overview
  - Empty section landings given an intro and card grid
- UQ purple theme, restyled navbar search, cycling light/dark/auto
toggle
- Preserve every old Hugo /docs/... URL (and legacy aliases) via
redirects
- Build and deploy to GitHub Pages with Node 20 instead of Hugo
@aswinnarayanan
aswinnarayanan merged commit 7a51910 into main Jun 22, 2026
@aswinnarayanan
aswinnarayanan deleted the migrate-to-starlight branch August 21, 2026 04:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant