re: Should Coding be Trivial? VIEW POST

TOP OF THREAD FULL DISCUSSION
re: My point is not about requirements specification or high level design. These need to be documented, at least to a certain extent before coding star...
 

Ah ok, my apologies Frank, I dived in :)

I too would have a problem with things like function prototypes in static documents, that does seem excessive. I think design decisions, such as the particular patterns selected to address a challenge, are worth recording, along with the reasoning behind them. This could be in a block comment in the code, or maybe on a confluence page as a picture with some explanation. As you have noted, all of this non-code work is debt to be maintained, so worth reviewing it's value at appropriate points.

code of conduct - report abuse