A collection of 8 posts
I've read several articles on “good comments”, I've written some, I've read technical books about “good comments” and I work on a JavaScript project where everything must be commented (jsdoc). I changed my mind about that matter. Self documenting code What I've...
Continuer à lire →This is often what is criticized for beginners but everyone knows it, beginner or not, many developers do not comment otherwise badly on their codes. Assuming you're here to change and start commenting your code. How to write quality comments? DRY for comments Writing comments is already not...
Continuer à lire →Dans cette série, nous allons faire un peu de veille ensemble. Le principe est simple, je vous parle de ce qui m’a intéressé dans les 7 jours de veille précédents et je vous mets un lien pour que vous puissiez en profiter aussi. La lecture, c’est ici Front-end...
Continuer à lire →L’article "Les meilleurs commentaires ne s’écrivent pas" que j’ai publié il y a quelque temps déjà a fait couler pas mal d’encre sur les réseaux sociaux et les blogs. Je suis content d’avoir fait réagir et d’avoir pu échanger sur le sujet...
Continuer à lire →J’ai lu plusieurs articles sur les "bons commentaires", j’en ai écrit, je lis des bouquins techniques qui traitent des "bons commentaires" et je travaille sur un projet JavaScript où tout doit être commenté (jsdoc). J’ai revu mon point de vue sur le sujet....
Continuer à lire →La documentation est très importante, on le sait. Et une bonne documentation passe aussi par les commentaires du code de votre application. Je vous avais même dit qu'il était possible de bien intégrer ses commentaires à son IDE pour qu'il les comprenne, les prenne en compte...
Continuer à lire →Ces dernières semaines, j'ai passé pas mal de temps à lire et étudier des articles de blogs, des projets github, des ebooks à la recherche de bonnes pratiques. J'ai toujours été attiré par les principes de code qui peuvent m'aider à faire du "...
Continuer à lire →C'est bien souvent ce que l'on reproche aux débutants, mais tout le monde le sait, débutant ou pas, beaucoup de développeurs ne commentent pas sinon mal leurs codes. En admettant que vous soyez ici pour changer et commencer à commenter votre code. Comment écrire des commentaires...
Continuer à lire →By clicking "Allow all", you agree to the storing of cookies on you device to enhance site navigation, analyse site usage, and assist in our marketing effort.