3 ms·
Programming is a form of writing with equivalent difficulty. The challenge therein is relative and yet orthogonal to the reading of code. This is best described
by austincheney 6y ago
Programming is a form of writing with equivalent difficulty. The challenge therein is relative and yet orthogonal to the reading of code. This is best described by perhaps the most prolific writer in human history: Isaac Asimov.
The most striking thing that Asimov said about writing is about correctness. A good writer produces correctness the first time. They aren’t reliant upon tools, gimmicks, or editors to catch syntax or grammar violations because these trivialities aren’t the important concerns. Drafts are for revising ideas and distilling ideas down to a clearer thought. For good writers drafts don’t waste time or focus with correctness.
In addition to writing with correctness the first time entirely from the author without a bunch of bullshit helpers good writers know what they want to write. They simply write it. They may not have a clarity of vision on how best to order or describe a given subject for their given audience but then that’s what drafts are for. Just write it. In programming revising drafts if called refactoring.
Perhaps the greatest difficulty in any writing is simplicity which is far more challenging than mere mortals consider. The quality of a written work is directly attributable to it’s simplicity.
Simplicity only ever means fewer. Fewer is directly applicable to both form and substance. Does the author rely upon an excess of syntax decoration or do the directly solve the problem? Likewise did the author take the extra effort to fold similar ideas into a single abstraction thereby reducing the number of pieces and methods of approach while simultaneously increasing the potential number of solutions?
https://github.com/prettydiff/wisdom/blob/master/Simplicity.md https://github.com/prettydiff/wisdom/blob/master/Simplicity....
- jwdunne 6y agoThis is an excellent comment and illuminates what I’ve come to realise myself re. the parallels of writing and programming. In fact, writing is a core part of my workflow: I write to problem solve. A clear problem definition and potential solution makes building the solution much, much easier. The linked article, unfortunately, buries the lede. When the headline is “Simple Writing”, it’d be a better piece if it started with that from the first sentence.
- mattmanser 6y agoIf it was so good, they'd have followed their own advice. It took them 250+ words to write "simplicity is good".
- austincheney 6y agoI have found that obtuse specificity is necessary on the subject because programmers are in general principally concerned with least effort and falsely conflate simplicity for that least effort via the word easy. It is not about good.
- jwdunne 6y agoNot sure if that’s the point of the comment. The point of the linked text, maybe, which is why I offered my critique. If “simplicity is good” was the only thing you took away from the comment, you might want to re-read it.
- idoubtit 6y ago> [...] perhaps the most prolific writer in human history: Isaac Asimov. Beware of unrelated claims that taint your message! Asimov, while a prolific writer, was certainly not the most productive. According to Wikipedia, he wrote or edited 500 books. Enid Blyton, mostly known for the Famous Five series, wrote more than 600. Even Georges Simenon had more than 500. The Guiness book mentions a little-known South-African author that wrote 904 books.