Skip to content

Conversation

@fulopkovacs
Copy link
Contributor

@fulopkovacs fulopkovacs commented May 3, 2025

This is PR lets the user access the markdown format of the documentation pages/guides, by adding a .md suffix to the end of the path.

With this change, the following (example) links would work as follows.

  • /form/latest/docs/framework/react/guides/basic-concepts serves React SSR'd version of the documentation.
  • /pacer/latest/docs/installation serves React SSR'd version of the documentation.
  • /form/latest/docs/framework/react/guides/basic-concepts.md serves the raw markdown for the documentation page.
  • /pacer/latest/docs/installation.md serves the raw markdown for the documentation page.

Why is it useful?

This feature is useful for using the documentation with LLMs, and was inspired by vite:

For every page you can get the original markdown by replacing the .html extension with .md - e.g.:

https://vite.dev/guide/rolldown
(Posted by Evan You)

This feature would let the user to pass the documentation pages as context to the LLM-s they use for specific versions of TanStack libraries, which would make sure that they always get the right information, even if there were breaking changes between versions.

@netlify
Copy link

netlify bot commented May 3, 2025

‼️ Deploy request for tanstack rejected.

Name Link
🔨 Latest commit 0b7a102

@SeanCassiere SeanCassiere changed the title POC for serving the markdown pages (useful for LLMs) feat: directly serve library document markdown May 7, 2025
@fulopkovacs fulopkovacs marked this pull request as draft May 11, 2025 21:41
Co-Authored-By: fuko <43729152+fulopkovacs@users.noreply.github.com>
@SeanCassiere SeanCassiere marked this pull request as ready for review May 20, 2025 11:19
@SeanCassiere SeanCassiere self-requested a review May 20, 2025 11:22
@fulopkovacs fulopkovacs self-assigned this May 20, 2025
@fulopkovacs fulopkovacs merged commit 285e63c into TanStack:main May 20, 2025
7 checks passed
Sign up for free to 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.

2 participants