J'ai travaillé dans des ateliers qui produisent des logiciels essentiels à la vie courante et j'ai traité des règles de commentaire destinées à garder le code lisible et potentiellement à sauver des vies. D'après mon expérience, l'exigence devient une corvée de cerveau fatal d'être cochée dans une...
J'ai vu cette partie de PEP-8 https://www.python.org/dev/peps/pep-0008/#package-and-module-names Je ne sais pas s'il s'agit du nom de fichier d'un module / classe / package. Si j’avais un exemple de chacun, les noms de fichiers devraient-ils tous être en minuscules avec des traits de soulignement,...
Le chapitre d'Oncle Bob sur les noms dans Clean Code vous recommande d'éviter les encodages dans les noms, principalement en ce qui concerne la notation hongroise. Il mentionne aussi spécifiquement la suppression du Ipréfixe des interfaces, mais n'en montre pas d'exemples. Supposons ce qui suit:...
Venant d'un arrière-plan principalement c #, je suis habitué à utiliser le terme "interface" pour décrire un objet sans implémentation définissant le comportement. En c #, la convention est d’ajouter des noms d’interface avec "I", comme dans IEnumerable, etc. Bien entendu, le concept a différents...
Quel est le meilleur nom pour une méthode qui retourne un booléen? IsSupportContentType ou CanSupportContentType
Je viens de bifurquer un projet dans Github, j'ai fait mes changements, etc. Cela m'a fait me demander: je vois surtout README.txt dans les projets open source et le fichier que j'ai édité était Readme.txt. Est-ce une sorte de standardisation ou aurais-je dû le laisser tel
S'il y a une méthode bool DoStuff() { try { // doing stuff... return true; } catch (SomeSpecificException ex) { return false; } } devrait-il plutôt s'appeler IsStuffDone()? Les deux noms pourraient être mal interprétés par l'utilisateur: Si le nom est: DoStuff()pourquoi renvoie-t-il un booléen? Si...
Si un logiciel / bibliothèque prend en charge la plate-forme Windows, il nomme presque toujours ses répertoires et variables comme win32. Ceci est plus répandu dans les projets C / C ++. Même la triple utilisation du projet MinGWwin32 . Y a-t-il une raison à cela? Pourquoi ne pas utiliser un nom...
J'ai récemment travaillé avec l' objet XMLHttpRequest en JavaScript, et je n'ai pas pu m'empêcher de remarquer que la casse de ce nom n'a aucun sens. Pourquoi «XML» est-il tout en majuscules alors que «Http» ne l'est pas? Ce sont deux acronymes! Il serait sûrement plus logique que le nom soit l'un...
C'est une convention assez établie que les noms de table de base de données, en SQL au moins, doivent être singuliers. SELECT * FROM user;Voir cette question et discussion . C'est également une convention assez établie que les noms de ressources de l'API RESTful doivent être pluriels. GET...
Cette question a été migrée depuis Stack Overflow car il est possible d'y répondre sur Software Engineering Stack Exchange. Migré il y a 8 ans . Je commence tout juste à apprendre le C #. Venant d'un arrière-plan en Java, C ++ et Objective-C, je trouve que le Pascal-Cing de C # est assez unique,...
Après avoir lu la réponse de gnat à Pourquoi une méthode principale statique en Java et C #, plutôt qu'un constructeur? Je suppose que sa réponse signifie que le but d'une classe Java avec une méthode principale statique est de define a program entry pointet qu'elle n'est pas censée être le...
Java SE 8 est livré avec un nouveau mécanisme pour les dates, l' introduction LocalDate, LocalTimeet des LocalDateTimeclasses pour représenter instants de temps. Pour manipuler ces instants, un ensemble de méthodes sont données: LocalDate.plusDays(...), LocalDate.minusDays(...)et ainsi de suite....
Quelle est l'histoire derrière la convention de nommage des constantes en majuscules? Mon intuition est que cela a commencé avec le préprocesseur C, où les gens ont développé une pratique pour nommer les macros de préprocesseur en majuscules afin qu'ils vivent efficacement dans un espace de noms...
Fermé . Cette question est basée sur l'opinion . Il n'accepte pas actuellement de réponses. Voulez-vous améliorer cette question? Mettez à jour la question afin d'y répondre avec des faits et des citations en modifiant ce message . Fermé il y a 4 ans . Lorsque vous utilisez des variables dont le...
Je travaille dans un projet qui traite des périphériques physiques, et je ne sais pas comment nommer correctement certaines classes de ce projet. Étant donné que les appareils réels (capteurs et récepteurs) sont une chose et que leur représentation dans le logiciel en est une autre, je pense à...
Je reçois beaucoup de critiques de la part d'autres programmeurs en raison de mon utilisation d'un boîtier complet pour toutes mes variables. Par exemple, votre programmeur typique utilisera employeeCountun nom de variable, mais j'utilise EmployeeCount. J'utilise un boîtier complet pour tout , que...
Dans le passé, nous avons fait de la notation hongroise. C'est maintenant considéré comme dépassé , et pour la plupart je ne l'utilise plus, mais je trouve toujours utilisé le m_préfixe pour indiquer les champs membres. Pour moi, si je lis le code de quelqu'un d'autre, et je vois ceci: count = 3;...
Supposons que j'ai un formulaire dans mon application Web où les utilisateurs peuvent télécharger une photo de profil. J'ai peu d'exigences concernant la taille du fichier, les dimensions, etc., mais lorsque l'utilisateur télécharge l'image, comment dois-je les nommer sur mon système? Je suppose...
Mon projet souffre actuellement de problèmes de dénomination de l'environnement. Différentes personnes ont des hypothèses différentes quant aux environnements à nommer ou à la désignation des noms, et cela crée de la confusion lors de leur discussion. J'ai fait un peu de recherche et je n'ai trouvé...