Add getting started guide

[machacekondra]

Summary by Sourcery

Add a getting started guide for running DCM locally and link it from the main documentation index.

Build:

• Update the hextra documentation theme dependency to version v0.12.1 in go.mod.

Documentation:

• Introduce a Getting Started guide detailing local setup, optional KubeVirt integration, verification steps, and configuration options for DCM.
• Link the new Getting Started guide from the main documentation landing page.

[sourcery-ai]

Hey - I've left some high level feedback:

• The compose.yaml download URL uses refs/heads/main; consider pinning this to a specific tag or commit to ensure the getting-started instructions remain stable as the gateway repo evolves.
• Double-check that the configuration defaults listed in the table (e.g., POSTGRES_USER, POSTGRES_PASSWORD, KUBERNETES_NAMESPACE) exactly match the values in compose.yaml to avoid drift between docs and actual behavior.

Prompt for AI Agents

Please address the comments from this code review:

## Overall Comments
- The `compose.yaml` download URL uses `refs/heads/main`; consider pinning this to a specific tag or commit to ensure the getting-started instructions remain stable as the gateway repo evolves.
- Double-check that the configuration defaults listed in the table (e.g., `POSTGRES_USER`, `POSTGRES_PASSWORD`, `KUBERNETES_NAMESPACE`) exactly match the values in `compose.yaml` to avoid drift between docs and actual behavior.

---

Sourcery is free for open source - if you like our reviews please consider sharing them ✨

• X
• Mastodon
• LinkedIn
• Facebook

_{Help me be more useful! Please click 👍 or 👎 on each comment and I'll use the feedback to improve your reviews.}

[machacekondra]

@pkliczewski @chadcrum Here is the website running with the getting-started guide:
https://machacekondra.github.io/dcm-project.github.io/docs/getting-started/

Feel free to try. Everything should work just OK from latest images.
Except CLI, you need to have this PR in order to have dcm sp resource get my-dev-vm command working.

[chadcrum]

I ran through the docs e2e successfully.

[machacekondra]

I ran through the docs e2e successfully.

@chadcrum Thanks! I've added a new section decribing registering another provider. If you can try as well, would be great.
Again deployed here, for easier reading: https://machacekondra.github.io/dcm-project.github.io/docs/getting-started/

[gabriel-farache]

small nitpick, especially on how to create a catalog item but this may be part of another PR as this one focuses on a getting started with a given example

[gabriel-farache]

Maybe we can add a section on how to build this file for another catalog item? Especially a link to the service type definition to let the users know what is currently shipped withing DCM and what can/should/must be defined in the catalog item level

[machacekondra]

Yes that would be great to document as well. I think we need section of how to craete catalog-item as well as section how to create policies. So let's do it as follow up.