J'appuie.
Grosso-modo, mets des commentaires quand le code n'est pas explicite, long, ou difficile à comprendre au premier coup d'oeil.
C'est très courant d'avoir un projet qui part avec une bonne volonté, mets plein de commentaire pertinent, et ne les mets pas à jour lors des changements. Ce qui fait que les commentaires sont à côté de la plaque et tu peux même te retrouver avec des informations inverses.
Je voulais me plonger sur ton code aujourd'hui, pour meubler ma pause, mais j'ai pas eu le temps finalement. Je tenterai de le faire dans la semaine.
Sinon, pour le versioning, je te conseils le site assembla.com, qui te permet d'en avoir relativement facile d'accès et gratuit. Bien sûr, c'est pour le cas où tu ne désirs pas en monter un en local toi-même ^^"