feat(agents): generate homepage markdown for AI agent consumption

[fredericsimard]

The homepage (overrides/home.html + overrides/locales/*.html) is templated HTML with no hand-authored markdown source, unlike every other page on the site. This adds a workflow that builds the site and converts the rendered homepage HTML to markdown per locale.

• add .github/workflows/generate-homepage-markdown.yml: runs on PRs touching the homepage template or locale files, builds the site, and commits the generated markdown back to the PR branch
• add scripts/html-to-markdown.js: converts site/<locale>/index.html to docs/<locale>/index.generated.md using turndown
• add scripts/package.json: turndown and jsdom dependencies

[Copilot]

Pull request overview

Adds an automated workflow + Node script to render the MkDocs homepage HTML and convert it into per-locale generated markdown files intended for AI agent consumption, bringing the homepage in line with the rest of the docs’ markdown-based content.

Changes:

• Add a GitHub Actions workflow to build the site on relevant PRs and commit generated docs/<locale>/index.generated.md back to the PR branch.
• Add a Node-based HTML→Markdown converter (Turndown + JSDOM) to extract main content and strip site chrome.
• Add a dedicated scripts/package.json for the converter’s dependencies.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 3 comments.

File	Description
.github/workflows/generate-homepage-markdown.yml	Builds MkDocs on PRs that touch homepage templates and commits generated markdown back to the PR branch.
scripts/html-to-markdown.js	Converts built homepage HTML into docs/<locale>/index.generated.md, removing navigation/footer chrome.
scripts/package.json	Defines the Node dependencies (jsdom, turndown) for the conversion script.

Comments suppressed due to low confidence (2)

.github/workflows/generate-homepage-markdown.yml:55

• This workflow attempts to push commits back to the PR branch, which will fail for PRs from forks because GITHUB_TOKEN won’t have contents: write. Guard the commit step so the workflow doesn’t fail on forked PRs.

      - name: Commit generated markdown
        uses: stefanzweifel/git-auto-commit-action@v5
        with:
          commit_message: "chore: regenerate homepage markdown for agents"
          file_pattern: "docs/*/index.generated.md"

scripts/html-to-markdown.js:18

• The script currently looks for build output under site/, but MkDocs is configured to emit HTML to generated/ (see config/en/mkdocs.yml:6). As-is, this will throw before conversion runs.

const SITE_DIR = path.join(process.cwd(), "site");
const DOCS_DIR = path.join(process.cwd(), "docs");

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.