Skip to content

Docs site: three pages are unreachable and llms-full.txt misses five documents #407

Description

@zantvoort
  • security.md, performance.md and common-patterns.md are published and indexed but unreachable: not in website/sidebars.ts and zero inbound links from any other doc. An undiscoverable security page is the worst of the three for a SQL-generating framework. (Nine docs total are absent from the sidebar; several are deliberate hub targets with inbound links, these three have none.)
  • website/scripts/generate-llms-full.sh hardcodes a 46-entry list against 52 docs. Missing: ai-reference.md, database-and-mcp.md, graalvm.md, jpa-cascades-vs-write-sets.md, ktor-integration.md, so the GraalVM and Ktor stories are invisible to any assistant reading the file. The script warns-and-continues on missing files and silently ignores new ones, so drift is invisible in both directions. Derive the list from sidebars.ts or fail the build on mismatch.
  • Once the backlog is clear, flip onBrokenLinks: 'warn' (website/docusaurus.config.ts:28) to throw.

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentation

    Type

    No type

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions