Does whispering to agents in docs actually help?

The blog post explores the trend of addressing agents directly in documentation and README files, questioning its effectiveness and examining user experiences. The author shares experiments conducted to analyze whether this communication style is beneficial or merely awkward, especially when instructions are also visible to human readers.