News for hackers. Stuff that matters.
Re:The day I taught AI to read code like a Senior Developer by Aurornis on Sunday January 05, 2025 @10:43AM (#42602495)
> this is something that I used to do with academic papers

Academic papers are designed to be read from start to finish. They have an abstract to set the stage, an introduction, a more detailed setup of the problem, some results, and a conclusion in order.

A structured, single-document academic paper is not analogous to a multi-file codebase.

Re:The day I taught AI to read code like a Senior Developer by rorytbyrne on Sunday January 05, 2025 @10:54AM (#42602581)
No, they are designed to elucidate the author's thought process - not the reader's learning process. There's a subtle, but important difference.

Also: https://web.stanford.edu/class/ee384m/Handouts/HowtoReadPape...

Re:The day I taught AI to read code like a Senior Developer by p1esk on Sunday January 05, 2025 @11:51AM (#42603031)
they are designed to elucidate the author's thought process - not the reader's learning process

No, it’s exactly the opposite: when I write papers I follow a rigid template of what a reader (reviewer) expects to see. Abstract, intro, prior/related work, main claim or result, experiments supporting the claim, conclusion, citations. There’s no room or expectation to explain any of the thought process that led to the claim or discovery.

Vast majority of papers follow this template.