As AI-assisted development becomes increasingly common, documentation is no longer consumed only by humans — AI agents (LLMs, code assistants, autonomous dev tools) also parse and interpret docs to generate implementations.
I'm actively using RubyUI in a Rails + Phlex project and noticed these friction points when working with AI-assisted development workflows.
There's a lot we could benefit if we have some tweaks on semantics and structure that provides better context to AI coding tools