How we use comments in code has come up a couple of times for me this week and when I looked, I realised we hadn't captured anything in the my teams's coding guide lines, so I added something: Uncle Bob Says : "It is well known that I prefer code that has few comments. I code by the principle that good code does not require many comments. Indeed, I have often suggested that every comment represents a failure to make the code self explanatory. I have advised programmers to consider comments as a last resort." Comments should always be 'why', never 'what' and only when absolutely necessary. If you feel the need to write a 'what' comment, put the code in a well named (read descriptive) function instead. There will be those of you who will be adamantly attached to your comments, but you don't need them. And at some point, in the past, now or in the future, you or someone else will update your code, making the comment wrong and forget to upd...
Orbital: Winner of the Booker Prize 2024 Samantha Harvey ISBN-13 : 978-1529922936 This book wasn’t for me. It’s a great idea, but it’s poorly realised. This is not a novel and not a textbook. I don’t think it knows what it is. It’s a bit all over the place, almost as uncomfortable to read as The Silmarillion . The characters do not distil in your mind, there’s no character building and no story. It’s over indulgent. The few serious messages it tries to get across, like climate change and world peace, have all been done by sci-fi authors for decades and done better. I don’t usually pay much attention to the Booker prize, but as Orbital sounded like a great idea and hinted at science fiction based in science fact, I thought it might be ok. It wasn’t and I am pleased it wasn’t any longer.