Documentation
Portée du sujet
Recherche…
Introduction
Fonction linguistique Thèmes
Une division naturelle consiste simplement à créer un sujet pour chaque fonctionnalité linguistique. Par exemple, Python a:
- Des classes
- Les fonctions
- Générateurs
- Décorateurs
- . . .
En revanche, les fonctionnalités peuvent être assez compliquées et il est facile de trouver beaucoup plus d'exemples que pour une seule page. Les classes ont par exemple 16 exemples. Certains d'entre eux pourraient probablement être déplacés vers d'autres rubriques, telles que l'héritage, les propriétés, les méthodes, etc.
Sac à main
Certains sujets sont des exemples vaguement associés sous un thème, tels que les fonctionnalités C # 6.0 et les pièges courants . Dans l'ensemble, ce style de sujet a été découragé, car les exemples par sujet étaient limités, car il n'y a pas d'endroit naturel pour arrêter d'ajouter du contenu.
Il est probablement préférable de déplacer les exemples vers un autre sujet (peut-être pour les fonctionnalités linguistiques ). Je n'ai pas vu cela fait, mais il est possible que ces sujets puissent être convertis en un méta-sujet qui comprend un exemple ou deux qui consiste en grande partie en des liens vers d'autres sujets ou exemples:
Trucs et astuces Perl
- Ne pas analyser XML avec une regex! Utilisez un module d'analyse XML .
- Si vous avez besoin de commenter des blocs de code entiers, utilisez un bloc de commentaires POD .
- . . .