Initial docs site based on Docusaurus

[dgarros]

Exploring what it would take to build the documentation for this repo with Docusaurus

[ogenstad]

A continuation of these could be that we read this info from files instead and have a way to test that it's valid so based on the above we'd have:

File: 0001_graphql_add_repo.gql

mutation AddRepository{
  CoreReadOnlyRepositoryCreate(
    data: {
      name: { value: "infrahub-demo-dc-fabric" }
      location: { value: "https://github.com/opsmill/infrahub-demo-dc-fabric.git" }
    }
  ) {
    ok
    object {
      id
    }
  }
}

File: 0002_shell_run_generator.sh

poetry run infrahubctl run generators/generate_topology.py topology=fra05-pod1

Description

When executing these tests we'd just follow the initial number to indicate order then after that it would be file type or command type followed by some optional information that isn't required.

So if we look at 0001_graphql_add_repo.gql only 0001_graphql_ would be required anything after that is just to help us or guide the language selection in an IDE. The second part graphql or shell would tell the test how to execute the command.

The tests themselves would need to be simple in terms of us just looking at the exit code.

[petercrocker]

Will take on a test for 0002_shell_run_generator.sh when this PR is done: opsmill/infrahub#5287

[cloudflare-workers-and-pages]

Deploying infrahub-demo-dc-fabric with    Cloudflare Pages

Latest commit:	8b23c03
Status:	✅  Deploy successful!
Preview URL:	https://57dcc12c.infrahub-demo-dc-fabric.pages.dev
Branch Preview URL:	https://dga-20241103-docs.infrahub-demo-dc-fabric.pages.dev

View logs

[petercrocker]

This got quite big. Scope is:

• setup docusaurus
• edit .md pages for site
• setup cloudflare app to generate temp docs site on PR
• setup ci pipeline to do linting, vale, build docs
• moved some docs commands to separate file snippets so they could be tested
• setup a unit test for the graphql query now imported in to docusaurus as a code snippet

[BeArchiTek]

Except comment in the diagram (non-blocking) LGTM