Exactly, it's better to document on the VCS. Comments there will be tied to that version of the code, can never go out of sync. It's also good to learn how th

Exactly, it's better to document on the VCS. Comments there will be tied to that version of the code, can never go out of sync. It's also good to learn how that piece of code evolved and what reasons to change. Avoids repeating past mistakes.