• Home
  • Technology
  • Gaming
  • Entertainment
  • World & Business
  • Science
  • Sports
  • AI
HomeTechnologyGamingEntertainmentWorld & BusinessScienceSportsAI
    • HomeTechnologyGamingEntertainmentWorld & BusinessScienceSportsAI
    • Home
    • Technology
    • Gaming
    • Entertainment
    • World & Business
    • Science
    • Sports
    • AI
    AI
    Reaction

    A human-written README and “AI English” for agents

    A developer argues that READMEs, blogs and posts are opportunities to connect with people through words.

    GR
    CM
    4 Sources, 3h ago, first seen 3h ago

    TLDR

    A developer says they wrote a new project’s README by hand for human readers, while its internal documentation uses “AI English” for agents. They argue that writing for people is about connection, not just avoiding AI-associated quirks such as em dashes.

    Combined views

    34.7K

    4 Sources, first seen 3h ago

    Combined views

    34.7K

    4 Sources, first seen 3h ago

    563 likes
    563 likes
    81 comments
    120 saves
    19 reposts
    Featured Source
    81 comments
    120 saves
    19 reposts

    Sentiment

    Positive——Negative

    Summary

    Not enough discussion yet.

    No sentiment analysis available yet.

    Sentiment

    Positive——Negative

    Summary

    Not enough discussion yet.

    No sentiment analysis available yet.

    Today's Rank

    #19

    Today's Rank

    #19

    4 Sources

    @rauchgWorking on a new little project. The 𝚁𝙴𝙰𝙳𝙼𝙴 is fully written by hand, because it's for human consumption. The documentation internals are AI English, because they're for agents. This little rule of thumb can make the world better. Blogs, tweets, READMEs: human communication. It's not even about "em dashes" or lack thereof. It's that it's the story-telling moment where you want to connect with other humans through their words.3h
    @charliermarsh@rauchg "This README is human-edited, but all code changes, PR summaries, and additional documentation were authored entirely by GPT-6 Astra in Codex."3h

    4 Sources

    @rauchgWorking on a new little project. The 𝚁𝙴𝙰𝙳𝙼𝙴 is fully written by hand, because it's for human consumption. The documentation internals are AI English, because they're for agents. This little rule of thumb can make the world better. Blogs, tweets, READMEs: human communication. It's not even about "em dashes" or lack thereof. It's that it's the story-telling moment where you want to connect with other humans through their words.3h
    @charliermarsh@rauchg "This README is human-edited, but all code changes, PR summaries, and additional documentation were authored entirely by GPT-6 Astra in Codex."3h