3 ms·
I have also been writing software for a while, and I agree with most of Martin's claims that qntm sites in that article. But I also agree that the example code
by lowbloodsugar 5y ago
I have also been writing software for a while, and I agree with most of Martin's claims that qntm sites in that article. But I also agree that the example code is utter crap. It violates most of the rules that Martin just gave in the chapter.
Now, having written technical documentation myself, and even "Welcome interns" docs, I understand that writing good examples of good code is quite hard. But on the other hand, if one is writing a book about good programming then take the time to write examples that actually demonstrate what was claimed in the preceding pages! Like, it would be better to have a comment saying "Imports elided for brevity and printing costs" rather than writing wildcard imports.