Docs site improvements

[dominikwilkowski]

No description provided.

[svict4]

Completely agree, I'd like to move the docs as part of the same repo.
If you're not au fait with cuttlebelle or pancake, it takes a minute to get up and running.

DTA has already done some work adding the designsystem using Gatsby, if we wanted to roll our own.
https://github.com/govau/oneAPS-website | https://oneaps.gov.au/
https://github.com/govau/observatory-website | https://observatory.service.gov.au/

Alternatively, Docusaurus is also an option, but we'd have to do a bit of work to add a AUDS skin.

[dominikwilkowski]

I think I will propose nextjs site that we statically build and host on github pages. Will look into it further soon.

[elisechant]

Eleventy could be a good option here, they support vanilla + React, that would work with the design.

[dominikwilkowski]

I want to first and foremost support no-js in the docs and eleventy no matter how hip it currently is will not allow us to do this. I think the best course of action here is to use nextjs and export it to static HTML and CSS

[elisechant]

This is a good idea 💯 I'm principally in agreement to doing this.

This work is very much dependent on #2 occurring first.