On: Remove Half of Your Documentation

[hu3]

In find that documenting the Why with code comemts helps. Keep it concise.

Something like:

// We no longer allow deleting users data immediately because we are required by law X in jurisdiction Y. See ticket #3256149