Recherche…


Introduction

Les sujets doivent être aussi simples que possible, mais pas plus simples. Celui-ci suggère quelques principes d'organisation vus sur la documentation de débordement de pile.

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



Modified text is an extract of the original Stack Overflow Documentation
Sous licence CC BY-SA 3.0
Non affilié à Stack Overflow