Skip to content

docs: Antora component and AsciiDoc migration - #4

Draft
cursor[bot] wants to merge 1 commit into
mainfrom
cursor/documentation-automation-system-7a9b
Draft

docs: Antora component and AsciiDoc migration#4
cursor[bot] wants to merge 1 commit into
mainfrom
cursor/documentation-automation-system-7a9b

Conversation

@cursor

@cursorcursorBot commented Aug 7, 2026

Copy link
Copy Markdown

Summary

Adds an Antora documentation component for the Dev-Centr docs portal and migrates existing flat Markdown guides to AsciiDoc.

Docs added/updated

  • Antora component (docs/antora.yml, docs/modules/ROOT/)
    • Introduction, delivery model, specification, AI reproduction spec, glass lens capabilities, editor integrations
    • Changelog index with detail pages backfilled from git history
  • README.adoc — primary readme with Docs | Dev-Centr badge and CI/Pages badge
  • README.md — updated links to docs.devcentr.org/code-lens/
  • CHANGELOG.md — unreleased entry for Antora migration
  • Cross-repo link updates — package READMEs, extension READMEs, demo App.tsx, implementations/REGISTRY.md

Codepaths covered

  • Portable spec and delivery model (spec/, @code-lens/core, @code-lens/vanilla)
  • Framework adapter installation patterns
  • Glass lens capability tiers and runtime probing
  • VS Code / Zed editor integration feasibility
  • Release history from v0.1.0 through v0.3.13

Key knowledge gaps addressed

  • No published docs site component existed; guides were flat Markdown not wired into the org Antora portal
  • README lacked Docs | Dev-Centr badge
  • Stale links (docs/*.md, amdphreak.github.io) across demo and package READMEs

Follow-up (cross-repo)

To publish at docs.devcentr.org/code-lens/, add this source to dev-centr/docsantora-playbook.yml:

- url: https://github.com/dev-centr/code-lens.gitbranches: HEADstart_path: docs

Optionally register @antora-supplemental/antora-ai-help-extension on the org playbook for AI-powered search (Lunr is already enabled).

Open in WebView Automation

- Add docs/antora.yml with ROOT module pages for ecosystem, specification,
AI reproduction spec, glass lens capabilities, and editor integrations
- Add changelog index with detail pages backfilled from git history
- Add README.adoc with Docs | Dev-Centr badge; update README.md links
- Point package, extension, and demo links at docs.devcentr.org/code-lens/
Co-authored-by: Ryan Johnson <AMDphreak@users.noreply.github.com>
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@cursoragent