Website

[aliok]

Partiall fixes #14

This PR adds a documentation website for the MCP Lifecycle Operator, similar to the structure used by kube-agentic-networking.

The site can be viewed locally by running make live-docs (Docker) or ./hack/mkdocs/local-serve.sh (Python venv)

Tech:

• MkDocs with Material for MkDocs theme
• Netlify (configuration included in netlify.toml) --> Netlify project and domain needs to be set up by someone with admin access
• API Documentation auto-generated from Go types using crd-ref-docs

Following the kube-agentic-networking model, we copied the CSS styling, theme configuration, build infrastructure and the general structure.

Verification:

make live-docs
# Starts server at http://localhost:3000

# or, Python virtual environment (faster)
./hack/mkdocs/local-serve.sh
#Starts server at http://127.0.0.1:3000

API reference is auto-generated from Go CRD types:

make api-ref-docs

Building for Production

  make build-docs          # Using Docker
  make build-docs-netlify  # Without Docker (for Netlify)

Output is generated in the site/ directory.

What needs to be done afterwards:

• Set up Netlify deployment (requires admin access)
• Configure custom domain (e.g., mcp-lifecycle-operator.sigs.k8s.io)

[aliok]

@matzew wanna take a first look?

[matzew]

Very nice! :)

[aliok]

@matzew another look?

[matzew]

/lgtm

[k8s-ci-robot]

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: aliok, matzew

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Details

Needs approval from an approver in each of these files:

• OWNERS [aliok,matzew]

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

[matzew]

/ok-to-test

[matzew]

/hold
for others to review

[aliok]

cc @jaideepr97 wanna take a look?

[k8s-ci-robot]

New changes are detected. LGTM label has been removed.

[aliok]

@Cali0707 I think I resolved all the comments you've made. Thanks for catching issues!

Another look? cc @matzew