News for hackers. Stuff that matters.
Re:Why we need a book about naming by EliRivers on Thursday February 13, 2020 @08:47AM (#22317661)
A well-written literate program is a joy to work with. To be able to genuinely understand a complex program's design by reading well-written prose which forms part of the source code. Literally reading code like a book, finding that it effectively has a plot and characters with understandable motivations, properly introduced and their places and relationships clearly understood. Done right, it can work so well.

The only software I ever worked on in which the customer never reported a single bug was written entirely in literate code.

The software I work on now is so much at the other end of the scale that sometimes when the customer reports something, there is a signficant period of investigation before deciding if it's a bug or if that's how it's meant to work.

Re:Why we need a book about naming by geocar on Thursday February 13, 2020 @11:56AM (#22319229)
I'm in 100% agreement. Literate programs can be a real treat, but I also think to add: So can any code.

Reading someone's code feels like peering into another persons head, trying to imagine both what they must have been imagining.

Sometimes that can be a real scary thing, but for those of us who like a good haunted house, it can be a real treat too.