LogFAQs > #962299576

MutantJohn posted...

I think you confused this with "writing your tests before writing the code".

Plus, safety-critical has extra components in the workflow added to it.

Again, comments really don't matter. They help, for sure, but they don't imply 1. software quality and 2. what the software actually does.

Comments are all talk whereas code is all walk, baby.

Both, but I meant commenting. It's incredibly useful to write a function description prior to writing code because you want to document what it SHOULD do so when things go wrong and someone else is trying to debug they undertand what the original intent was. Plus inline commenting prior to writing code is incredible for organization and structure. If you write your block comments before putting the implementation underneath, it also means any TODOs you throw in there are paired with what it eventually has to do. It saves a lot of time in the long run because you've fully thought through the end-to-end functionality of a function prior to starting the process of implementing it which catches any gaps in logic but also means if you have to resume another day its easy to tell where you left off.