Document Intentional Decisions For Code That Would Break If Changed/Removed [DP5] [WHY]

Document Intentional Decisions For Code That Would Break If Changed/Removed [DP5] [WHY]

Tip DP5

If you spent time making any other kind of intentional decision about some code that would break if someone changed or removed that code, you should document that.

This is particularly applicable for things like styling in web code. If that whole web page layout would be busted by someone removing that margin styling, make sure to document that!

See the following examples:

Busy coding or busy meeting ad.png