[dprotaso]

Adds incremental rebuilds to the local docs preview, using MkDocs' standard live-reload server.

# Preview your working copy at /docs/
./hack/mkdocs.sh

# Include cached releases; working copy is at /development/
./hack/mkdocs.sh --all-versions

# Same thing with Docker
./hack/docker/run.sh --all-versions

No extra flags needed. Markdown body edits reuse release HTML. CSS, JS and image edits skip page rendering. Shared dependencies and page-index changes trigger full rebuilds.

Median build times from three local runs with all versions enabled and release sources cached (excludes browser reload):

Change	MkDocs without incremental builds	This PR
Initial full build	12.62s	13.10s
Markdown body edit	13.03s	7.48s
CSS asset edit	13.24s	0.95s
Markdown edit adding an anchor	12.99s	21.09s

About 43% less time for Markdown body edits and 93% less for assets. Markdown edits render 358 pages instead of 1,047; asset edits render none.

Anchor changes are slower: we first render the working copy, detect the changed page index, then rebuild all versions so version-selector links stay correct.

[knative-prow]

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: dprotaso

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 [dprotaso]

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

[netlify]

✅ Deploy Preview for knative ready!

Name	Link
🔨 Latest commit	4590415
🔍 Latest deploy log	https://app.netlify.com/projects/knative/deploys/6ae019bb4265f1eee182de1a
😎 Deploy Preview	https://deploy-preview-6752--knative.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.