[Request]: Friendly AI Agent Documentation

[21Chani]

What is this request related to?

Request

📋 Suggested

Support markdown files in documentation
Example:
https://docs.solidjs.com/concepts/intro-to-reactivity to support: https://docs.solidjs.com/concepts/intro-to-reactivity.md

📋 General description or bullet points

Hey guys, I've been messing with the SolidJS docs these days, and I was wondering if it's on the plan to replace the current docs with AI-friendly docs.
With the current expansion of AI models and usage in the tech space, leaving the current docs as they are without support for new AI agents is basically asking to be swallowed by the new coding era.
When coding with an AI agent in a React repo, it feels much smoother to do it with small prompts compared to SolidJS patterns. Part of this is because agents struggle to learn how to code with SolidJS, while React makes this very easy.
https://react.dev/learn/thinking-in-react.md
vs.
https://docs.solidjs.com/concepts/intro-to-reactivity.md 👎🏽 (Page doesn't exist.)

I would love to participate in or lead such a feature, but I need confirmation that this is something desired by the team.

🖥️ Reproduction of code samples in StackBlitz

No response

[LadyBluenotes]

Thanks for the suggestion — this is something we've been thinking about as well.

At the moment, we don't have plans to replace the existing documentation with a separate set of “AI-friendly” docs. The current docs are still the primary source of truth for Solid, and we want to continue improving them for human readers rather than splitting the ecosystem across multiple documentation formats.

That said, we do have some things in the pipeline aimed at improving how Solid knowledge can be consumed by tools and agents. Those efforts are currently a bit shifted because a lot of the team's focus is on making sure the documentation and ecosystem are ready for Solid 2.0 and that users have a smooth experience there.

Once things settle on that front, there are a few things planned that should start landing over the next few weeks that move us in this direction.

Appreciate you raising the idea, and thanks for offering to help.