potiuk commented on PR #58430: URL: https://github.com/apache/airflow/pull/58430#issuecomment-3549041236
> > Docs are longer than I'd like, but make sense. > > The thing is that AI actually likes detailed context. This documentation is also for AI agents to understand what they should do by reading the documentation. Again - i do not expect people to read them like a book, more like trying to find what they are looking for - but I do 100% expect it will be read by Gen-AI tools in it's entirety to build the right context for whatever they will be doing. Speaking of which... When I realized and checked how Agents work, I kind of started to see why I added such a detailed documentation for all things in our env. Thanks to this I do not even have to ask Cloude how to run the tests or build breeze image and run things sometimes - it just **knows** by reading our docs and I do not have to explain it in my prompts. It happened multiple times when I was using agents, that they added tests and iterated on them and created a number of them following the structure and description of our test environment without me even asking for it. -- 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]
