Humans are still the real readers of your documentation

As AI agents increasingly consume documentation to execute tasks automatically, the actual humans affected by those outcomes remain the ultimate audience. The article argues that while AI serves as the delivery mechanism, documentation accuracy has become critical infrastructure — errors that humans might catch now propagate uncorrected through automated systems at scale. Writing clear, accurate documentation for humans and optimizing for machine readability are complementary goals, not competing ones.