tag:blogger.com,1999:blog-36547168.post3518708518796751..comments2023-11-25T11:00:42.257+01:00Comments on Invisible to the eye: Readable code is not for maintenance onlyGiorgiohttp://www.blogger.com/profile/03558287012747987157noreply@blogger.comBlogger6125tag:blogger.com,1999:blog-36547168.post-54671793528324905752009-10-06T19:46:56.003+02:002009-10-06T19:46:56.003+02:00@fsilber: I dream that static analysis of code wil...@fsilber: I dream that static analysis of code will one day be able to stop commits of bad code... For short identifiers and violated standards it can already. :)Giorgiohttps://www.blogger.com/profile/12689416577856305650noreply@blogger.comtag:blogger.com,1999:blog-36547168.post-23315984758005896682009-10-06T18:07:07.919+02:002009-10-06T18:07:07.919+02:00Unfortunately, there are all too many programmers ...Unfortunately, there are all too many programmers with better than optimal short-term memories. They can remember the contents of a dozen poorly named variables and methods while reading a five page program. In fact, if they've developed prodigious memories to compensate for being slow readers, they might even prefer variable names that are short and ambiguous over names that are explicit but long.<br /><br />Unfortunately, the profession provides no way to punish them for being like that; indeed, they're often rewarded for their ability to churn out pages of code quickly.fsilbernoreply@blogger.comtag:blogger.com,1999:blog-36547168.post-44754378621472509292009-10-05T18:27:26.012+02:002009-10-05T18:27:26.012+02:00@Benjamin: I've already read it some months ag...@Benjamin: I've already read it some months ago, and I liked it. :) My favourite text on this subject is "Practical API Design: Confessions of a Java Framework Architect", which goes well beyond everything a developer needs to know about designing a good library.<br />@Gigi: thanks for finding the typo.Giorgiohttps://www.blogger.com/profile/12689416577856305650noreply@blogger.comtag:blogger.com,1999:blog-36547168.post-63937644230725345052009-10-05T17:31:27.342+02:002009-10-05T17:31:27.342+02:00You would probably like The Little Manual of API d...You would probably like The Little Manual of API design<br /><br />http://chaos.troll.no/~shausman/api-design/api-design.pdfAnonymousnoreply@blogger.comtag:blogger.com,1999:blog-36547168.post-33778920073463483392009-10-05T16:46:56.122+02:002009-10-05T16:46:56.122+02:00+1 Gigi+1 GigiAnonymousnoreply@blogger.comtag:blogger.com,1999:blog-36547168.post-28953109028645549302009-10-05T15:47:36.982+02:002009-10-05T15:47:36.982+02:00tipycal => typicaltipycal => typicalGigihttps://www.blogger.com/profile/06020715328842596209noreply@blogger.com