Documentation
Themenbereich
Suche…
Einführung
Sprachfeature Themen
Eine natürliche Unterteilung besteht einfach darin, für jedes Sprachmerkmal ein Thema zu erstellen. Zum Beispiel hat Python :
- Klassen
- Funktionen
- Generatoren
- Dekorateure
- . . .
Ein Nachteil ist, dass Funktionen sehr kompliziert sein können und es leicht ist, mehr Beispiele zu finden, als für eine einzelne Seite sinnvoll sind. Klassen hat zum Beispiel 16 Beispiele. Einige davon könnten möglicherweise in andere Feature-Themen verschoben werden, z. B. Vererbung, Eigenschaften, Methoden usw.
Greifertasche Themen
Einige Themen sind lose verknüpfte Beispiele unter einem Thema, z. B. C # 6.0-Funktionen und Häufige Fallstricke . Insgesamt wurde von diesem Themenstil abgeraten, da die Beispiele pro Thema begrenzt waren, da es keinen natürlichen Platz gibt, um das Hinzufügen von Inhalten zu beenden.
Es ist wahrscheinlich besser, die Beispiele in ein anderes Thema zu verschieben (vielleicht für Sprachfeatures ). Ich habe das noch nicht gesehen, aber es ist möglich, dass diese Themen in ein Meta-Thema umgewandelt werden, das ein oder zwei Beispiele enthält, das im Wesentlichen aus Links zu anderen Themen oder Beispielen besteht:
Perl-Tipps und Tricks
- Analysieren Sie XML nicht mit einer Regex! Verwenden Sie ein XML-Parsing-Modul .
- Wenn Sie ganze Codeblöcke auskommentieren müssen, verwenden Sie einen POD-Kommentarblock .
- . . .