Skip to content
This repository was archived by the owner on May 29, 2026. It is now read-only.

feat(docs): wire AI-crawler baseline (preset 3.4.0 + validator + llms.txt)#136

Merged
rubenvdlinde merged 1 commit into
developmentfrom
feat/docs-ai-baseline
May 18, 2026
Merged

feat(docs): wire AI-crawler baseline (preset 3.4.0 + validator + llms.txt)#136
rubenvdlinde merged 1 commit into
developmentfrom
feat/docs-ai-baseline

Conversation

@rubenvdlinde

Copy link
Copy Markdown
Contributor

Summary

Wires the AI-crawler baseline that landed fleet-wide in conduction-website#55 and .github#73.

The fleet rollout previously skipped this repo because the agent looked at `apps-extra/larpingapp/` (which has a personal-fork remote) and missed the canonical `ConductionNL/LarpingNextApp` Docusaurus site. This PR closes that gap.

What changed

  • `docs/package.json`: `@conduction/docusaurus-preset` bumped from `^2.6.1` to `^3.4.0`. Preset 3.4.0 ships Organization + WebSite JSON-LD on every page, SoftwareApplication via ``, FAQPage via ``, default og:image + twitter meta, and a postBuild plugin that emits robots.txt when the site doesn't ship its own.
  • `docs/package.json` scripts: `postbuild` runs the validator after every build; `validate:ai-baseline` for ad-hoc runs.
  • `docs/scripts/validate-ai-baseline.mjs` (new): generic 8-check validator. Asserts robots.txt + Sitemap line + AI-bot allow lines, sitemap.xml emits >= 1 URL, homepage has Organization + WebSite JSON-LD + og:image + twitter:* meta, og:image URL resolves to a real file. Exits 1 on regression.
  • `docs/static/llms.txt` (new): llmstxt.org index with LarpingApp intro paragraph, doc link block to the live site, and Conduction contact.

CI

The merged `.github#73` workflow change means this PR triggers a build + validate run on every push to the branch. The 8-check validator must pass for the PR to merge cleanly.

Test plan

  • CI runs the new `validate:ai-baseline` check via the postbuild hook
  • Validator reports 8/8 passing after the preset bump
  • Build output emits `robots.txt`, `llms.txt`, JSON-LD on the homepage, og:image

….txt)

Matches the fleet rollout pattern from ConductionNL/conduction-website#55:

- docs/package.json: @conduction/docusaurus-preset bumped from ^2.6.1
  to ^3.4.0 (ships Organization + WebSite JSON-LD on every page,
  SoftwareApplication via <DetailHero>, FAQPage via <FAQ>, default
  og:image + twitter meta, postBuild robots.txt fallback).
- docs/package.json scripts: postbuild npm hook runs the validator
  on every build, validate:ai-baseline alias for ad-hoc runs.
- docs/scripts/validate-ai-baseline.mjs (new): generic 8-check
  validator. Asserts robots.txt + Sitemap, AI-bot allow lines,
  sitemap.xml, Organization + WebSite JSON-LD, og:image, twitter
  meta, og:image file resolves. Exits 1 on regression.
- docs/static/llms.txt (new): llmstxt.org-format index. LarpingApp
  intro + docs link block + Conduction contact.

CI gate runs via ConductionNL/.github documentation workflow on
every PR (post that workflow's split-build-from-deploy change).
@github-actions

Copy link
Copy Markdown
Contributor

Quality Report — ConductionNL/larpingapp @ b1a2742

Check PHP Vue Security License Tests
lint
phpcs
phpmd
psalm
phpstan
phpmetrics
eslint
stylelint
composer ✅ 94/94
npm ✅ 376/376
PHPUnit
Newman ⏭️
Playwright ⏭️

Coverage: 0% (0/10 statements)


Quality workflow — 2026-05-18 18:16 UTC

Download the full PDF report from the workflow artifacts.

@rubenvdlinde rubenvdlinde merged commit df88921 into development May 18, 2026
22 checks passed
@rubenvdlinde rubenvdlinde deleted the feat/docs-ai-baseline branch May 18, 2026 18:17
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant