Faut-Multi-Commentaires ligne doivent être amortis?

Corrigez-moi si Im tort, mais ne sont pas des choses comme plusieurs commentaires en ligne mis en avant l'utilisation généralisée de la prolifération des serveurs HTTP et les pages web?
Il me semble que d'encombrer les fichiers de code de longs commentaires devraient être amortis en faveur de 2-3 commentaires en ligne avec un lien vers une page de documentation réelle et peut-être que les pages de documentation du titre. Que vous utilisiez ou "/**/" "//", Yould encore utiliser 4 caractères à insérer un commentaire avec un titre de la page et l'URL. Id affirment que la forme seule ligne est encore plus facile à taper.

Je crois que plusieurs observations bordées sont plus utiles pour l'enregistrement des blocs de code que vous avez besoin, mais ne veulent pas être analysée et que vous souhaitez conserver dans le même fichier. Sinon, ouais, ils ne devraient pas être utilisés. Toutefois, theyre également utilisé pour les moteurs de la documentation déjà, donc je ne peux pas me plaindre vraiment. Je déteste aussi gigantesques multi-alignés commentaires...ET Visual Studios plusieurs lignes de correction commentaire.

Yep, sonne comme commentant des blocs de code pourrait être un facteur de rupture.

Utilisent souvent plusieurs lignes de commentaires pour une intro à un fichier, le but, auteur, date etc Parfois, il permet simplement au moment de déterminer ce que les fichiers ne.

Je dois être un des rares personnes qui l'ont presque jamais lit les commentaires dans les fichiers de code. Je lis les commentaires succincts qui disent des choses comme " Son fait de cette façon à cause du bogue #12345 ». Thats about it though.

J'aime documenter chaque ligne de mon code pour me dire ce que chaque ligne fait...pas parce que j'ai à court terme la perte de mémoire, mais parce que si je donne ce code à quelqu'un, je n'ai pas de passer une heure en expliquant pourquoi j'ai fait quelque chose de cette façon et cela sera plus facile de remarquer une erreur de logique.

Utiliser les commentaires sur plusieurs lignes avant toute fonction raconter ce que la fonction ne et au début de chaque fichier avec mon avis et autres choses amusantes.

On pouvait voir certains de mes travaux Ici . Vous devez être inscrit et connecté pour voir les fichiers là cependant. Si vous arrivez à voir ces photos, vous seriez en mesure de voir ce que je veux dire par un commentaire sur chaque ligne de code PHP.