aglinxinyuan opened a new issue, #4932:
URL: https://github.com/apache/texera/issues/4932

   ## Background
   
   [llms.txt](https://llmstxt.org/) is an emerging convention for exposing a 
site's documentation in a machine-readable index that LLM agents can consume — 
conceptually similar to a sitemap for crawlers, but aimed at agents. It gives 
them a directory/menu of the site's content so they can navigate and answer 
questions about the project.
   
   Example from ng-zorro: https://ng.ant.design/llms.txt
   
   ## Motivation
   
   Texera's documentation is hosted on texera.apache.org. Publishing an 
`llms.txt` would let agents:
   
   - Answer questions like "does Texera support X?" by reading the docs index 
instead of scanning source code.
   - Serve as a foundation for a Texera agent knowledge base (similar to what 
Spark has done).
   - Provide a low-cost, structured entry point that we can grow as more 
content lands on apache.org.
   
   ## Proposal
   
   1. Add `llms.txt` to 
[apache/incubator-texera-site](https://github.com/apache/incubator-texera-site) 
so it is served at `texera.apache.org/llms.txt`.
   2. Add an `AGENTS.md` to that repo noting that `llms.txt` should be kept in 
sync when site content changes (updates are expected to be infrequent).
   3. Gradually expand coverage as more content moves onto apache.org.
   
   ## References
   
   - llms.txt spec: https://llmstxt.org/
   - Example: https://ng.ant.design/llms.txt
   - Site repo: https://github.com/apache/incubator-texera-site


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]

Reply via email to