Commentaires, après seulement "Hello, World!" En programmation, sont généralement la prochaine chose que vous apprenez après avoir salué le monde. Ils se présentent généralement sous deux formes: commentaires en une seule ligne et commentaires multi-lignes, tels que//et/ * * /. Leur objectif est d'expliquer la logique de code actuelle et de fournir des annotations.
Avant de plonger dans la question "Pourquoi personne ne veut plus d'écrire de commentaires de code?", Voyons d'abord comment les gens écrivent réellement des commentaires.
Par exemple, certains projets ou normes de codage nécessitent la déclaration des informations sur le droit d'auteur au début d'un fichier. Cela pourrait inclure les détails ASCII de l'art ou de l'octroi de licences:
/ * * Copyright 2024-2025 L'auteur ou les auteurs originaux. * * Licencié sous la licence Apache, version 2.0 (la "licence"); * Vous ne pouvez pas utiliser ce fichier sauf conforme à la licence. * Vous pouvez obtenir une copie de la licence à * * https://www.apache.org/licenses/license-2.0 * * sauf si la loi applicable ou convenu par écrit, logiciel * distribué sous la licence, est distribué sur une base "en tant que", * sans garanties ou conditions d'aucune sorte, exprimée ou impliquée. * Voir la licence pour la langue spécifique régissant les autorisations et les * limitations sous la licence. * /Certains incluent même l'art ASCII:
/ * * _OO0OO_ * O8888888O * 88 "." 88 * (| -_- |) * 0 \ = / 0 * ___ / `--- '\ ___ *.' \\ | | // '. * / \\ ||| : ||| (// \ * / _ ||||| -: - ||||| - \ * | | \\\ - /// | | * | \ _ | '' \ --- / '' | _ / | * \ .- \ __ '-' ___ / -. / * ___ '. . /- .-- \ `. .'___ *. "" '<`.___ \ _ <|> _ / ___.' > '"". * | | : `- \` .; `\ _ /` ;.`/ -`: | | * \ \ `_. \_ __\ /__ _/ .-` / / * =====`-.____`.___ \_____/___.-`___.-'===== * `=---=' * * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ * * Buddha bless, never plante, jamais les bugs * /Lorsque vous travaillez dans une entreprise, il est courant de déclarer l'auteur d'une fonction. Si la fonction a des problèmes, il est pl...
[Courte citation de 8% de l'article original]