Comment on commenting.
UPDATE: 06/12/2025 - Linked to a summary post dedicated to deep dive long form posts. https://leedare-plex2e.blogspot.com/2025/12/synon-2e-technical-deep-dives.html Hello, Comments are an essential part of any coding practice whether you are using traditional languages that are quite verbose with their syntax and vocabulary i.e. Java, C# or RPG/COBOL. Even code generation environments like 2E and Plex benefit hugely from appropriate commenting. Modern low-code platforms like Appian, Mendix and Outsystems (to name a few) who shield you from code (as much as possible) benefit from correctly named functions and comments/annotation within them. Without comments, what was as relatively simple coding process to the creator is now a moderate pain in the butt for the developer maintaining your code. Multiply that with a complicated piece of technical logic and/or business logic which is now practically impossible for a maintenance developer to pick up and be successful. ...