Comments

Hacker News

Seems like there's a lot of documentation oriented tools coming out right now. I guess this is a little different since it's a separate wiki, but genuine question L why do we need this so much documentation anymore when you can just ask an agent questions about what it does? Are there actual numbers or something saying that agents read documentation better than code? Because otherwise, it's kind of a waste of tokens filling up context (especially inline) with descriptive documentation.

by sightspinner

Fair question, i’d love to see data showing docs actually reduce agent exploration and token use versus just reading the code

by bignet

Join the discussion

Write your take first — we'll ask for email only when you're ready to publish.

  • Hacker News
  • Seems like there's a lot of documentation oriented tools coming out right now. I guess this is a little different since it's a separate wiki, but genuine question L why do we need this so much documentation anymore when you can just ask an agent questions about what it does? Are there actual numbers or something saying that agents read documentation better than code? Because otherwise, it's kind of a waste of tokens filling up context (especially inline) with descriptive documentation.
    by sightspinner
  • Fair question, i’d love to see data showing docs actually reduce agent exploration and token use versus just reading the code
    by bignet

Related stories