Documentation
Documentation
Posted Mar 19, 2022 15:05 UTC (Sat) by rgmoore (✭ supporter ✭, #75)In reply to: Documentation by tialaramex
Parent article: Donenfeld: Random number generator enhancements for Linux 5.17 and 5.18
Comments however are the last resort, because we're writing code which inherently _has_ meaning.
Not at all. Code, or at least clearly written code, is excellent at explaining what it does, but it is normally silent on why it was done that way. You can give hints through suggestive variable names and the like, but ultimately explaining your design decisions needs to be done through comments, commit messages, or other forms of documentation.