Re:“My Code is Self-Documenting”
by RangerScience on Friday January 27, 2017 @03:47PM
(#13502523)
I'd say then that your comments [regarding intent] are overly specific.
If updating the code block results in code with a different intent... you're not updating it, you're replacing it, and should take out the original comment with the original code.
If I have a code block to maintain data synchronization with a a server - that's the intent; if the code is updated from long-polling to websockets, the intent hasn't changed.
If updating the code block results in code with a different intent... you're not updating it, you're replacing it, and should take out the original comment with the original code.
If I have a code block to maintain data synchronization with a a server - that's the intent; if the code is updated from long-polling to websockets, the intent hasn't changed.