X XFediYour place in the Fediverse
XFEDI

Remote profile

ActivityPub
Profile banner

best practices for dev+test

@[email protected]

Michael Foord's 30 best practices for software development and testing

Open remote profile ↗
Posts

9a. Inevitably, code comments become lies over time. In practice, few people update comments when things change. Strive to make your code readable and self-documenting through good naming practices and known programming style. (This particular point about comments being lies is controversial, by the way. I still think it’s correct, and Kernighan and Pike, authors of The Practice of Programming, agree with me.)

↩ Reply ♡ 0 · ↻ 0 ↗ Original

26. Let’s be engineers! Let’s think about design and build robust and well-implemented systems, rather than growing organic monsters. Programming is a balancing act, however. We’re not always building a rocket ship. Over-engineering (onion architecture) is as painful to work with as under-designed code. Clean Architecture: A Craftsman’s Guide to Software Structure and Design is a good resource on this topic. Design Patterns is a classic programming book that every engineer should read.

↩ Reply ♡ 0 · ↻ 0 ↗ Original