Repository navigation
Conversation
Interface-only checkpoint for review: route-to-.md path mapping, the HTML-to-Markdown conversion contract, the postBuild plugin contract and the Accept-negotiation edge function contract. Every function throws "Not implemented"; nothing is registered in docusaurus.config.js or declared in netlify.toml, so builds and deploys are unchanged. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Build: a postBuild plugin (src/plugins/markdown-export) converts each rendered docs page to <route>.md, keeping every code tab variant with its label, admonitions as GitHub alerts, KaTeX source, images, and Mermaid source (exposed by a theme wrapper, since Mermaid renders in the browser). A conversion error fails the build. Discovery: docs pages get <link rel="alternate" type="text/markdown"> and a visually hidden notice. The markdown-negotiation edge function serves the .md to requests whose Accept header prefers text/markdown and falls back to the normal response when no .md exists. Tests run with node --test and in the PR workflow. The commented-out signalwire llms-txt config is removed; the package itself still needs `yarn remove`. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- Table cells with block content keep one line per block, joined by <br>. - Cards that are one big link keep their content and get one link, labelled with the button text. - Font Awesome icons no longer leave empty `**` emphasis. - Admonition and details titles keep their links; bold inside a title is unwrapped instead of nested. - Mermaid source travels URI-encoded in data-markdown-content: the rspack HTML minifier turned the text `&<br>` into a <br> element. - DeploymentCards stage tabs are marked data-copy-exclude. - IdAnatomy hides its grid from screen readers and the export, and adds a visually hidden list grouped by part. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Scalar renders /weaviate/api/rest and /engram/api/rest in the browser, so their HTML has nothing to convert. The plugin now converts each Scalar page's spec file (static/specs/*.json) with @scalar/openapi-to-markdown: - /weaviate/api/rest.md: introduction, then each tag's operations and a link to its file; /weaviate/api/rest/<tag>.md: the full reference for one tag. The whole document is about 490 KB, too large for one fetch. - /engram/api/rest.md: the whole reference, as its spec declares no tags. Both pages also get <link rel="alternate"> tags for the Markdown and the spec. The converter requires Node 22.19, so engines.node is raised. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- Mark the "Questions and feedback" heading data-copy-exclude with a remark plugin. Its section body is already excluded, so 327 Markdown files and the "Copy page" output ended with an empty heading. - Cards with a title and description become `[Title](url): Description` instead of two links to the same URL. - Fragment links get the page URL, because Markdown headings lose custom heading IDs such as #no-vector. - Badge links under code blocks become one `See also:` line instead of links run together. - ErrorDocs step numbers are data-copy-exclude, so the Markdown no longer reads "1. 1". Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- The edge function fetches the .md with redirect: "manual". A moved page's .md path can match a wildcard redirect (/weaviate/schema/* to /weaviate/manage-collections); following it served that page's HTML as Markdown with status 200, instead of the page's own redirect. - A button inside a paragraph keeps its text, so the quickstarts read "use the Ask AI feature" instead of "use the feature". - The README states the Node version the tests need. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
![orca-security-eu[bot]](https://avatars.githubusercontent.com/in/276244?s=60&v=4){kind=small}
There was a problem hiding this comment.
Orca Security Scan Summary
| Status | Check | Issues by priority | |
|---|---|---|---|
 Passed |
Infrastructure as Code |  0  0  0  0 |
View in Orca |
 Warning |
SAST | 1 0 0 0 |
View in Orca |
| Passed |
Secrets | 0 0 0 0 |
View in Orca |
| Passed |
Vulnerabilities | 0 0 0 0 |
View in Orca |
🛡️ The following SAST misconfigurations have been detected
| NAME | FILE | ||
|---|---|---|---|
|
User Controlled URL in HTTP Client Libraries May Lead to SSRF | ...kdown-negotiation.ts | View in code |
Note: The scan should have failed if no policies were configured in warn-only mode.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What's being changed:
Add Markdown versions of docs at
.mdsuffix pathsType of change:
How has this been tested?
yarn start