Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Ai readable MD file for docs #1987

Closed
138n4379 opened this issue Jan 24, 2025 · 2 comments
Closed

Ai readable MD file for docs #1987

138n4379 opened this issue Jan 24, 2025 · 2 comments

Comments

@138n4379
Copy link

Its bad enough having to fight with Ai about the current date and how things over time get updated, but me having to painstakingly hand build .md formatted files for the Ai is getting tiresome. Sure I and millions of other devs can sick our scraping bots and drive up your traffic volume OR please, please just give a link to a .md with current docs when you publish them. It would make life so much easier, and with so many breaking changes and totally new conventions from v3 to v4, can you cut us devs a break? Tell me where to donate if that what it takes.

@adamwathan
Copy link
Member

Hey thanks for the suggestion! Can't say if we're going to be able to prioritize anything like this any time soon, but you can find the raw MDX source files in the repo in case that's helpful:

https://github.com/tailwindlabs/tailwindcss.com/tree/main/src/docs

If you have a link to another project that offers their docs in this format I would be curious to see to get a sense of the effort involved, but yeah can't make any promises I'm afraid, billion things to work on and can only do one thing at a time.

Going to close regardless since we only use issues for bugs and this isn't a bug.

@138n4379
Copy link
Author

138n4379 commented Jan 25, 2025

That's great thanks for the insight. The AIs keep thinking v3 or v2, and keep wanting to change the code. It would be cool to have a universal format (md) of latest documents located in standardized place, like sitemap.XML or robots.txt is. This way you don't get millions of scrapers and individuals skewing any kind of metrics. Even on open source projects metrics are important.

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

No branches or pull requests

2 participants