Documentation
Область темы
Поиск…
Вступление
Язык
Естественное разделение - просто сделать одну тему для каждой языковой функции. Например, Python имеет:
- Классы
- функции
- Генераторы
- Декораторы
- , , ,
С другой стороны, функции могут быть довольно сложными, и легко придумать много примеров, чем иметь смысл для одной страницы. Например, классы имеют 16 примеров. Некоторые из них, вероятно, могут быть перенесены на другие темы, такие как Наследование, Свойства, Методы и т. Д.
Захватить сумку Темы
Некоторые темы являются примерами, связанными с непринужденностью, например, с функциями C # 6.0 и распространенными ошибками . В целом этот стиль темы был обескуражен, так как примеры по теме были ограничены, так как нет естественного места для прекращения добавления контента.
Вероятно, лучше переместить примеры в другую тему (возможно, для языковых функций ). Я не видел этого, но возможно, что эти темы могут быть преобразованы в метатег, который включает пример или два, который состоит в основном из ссылок на другие темы или примеры:
Советы и хитрости Perl
- Не разбирайте XML с регулярным выражением! Используйте модуль синтаксического анализа XML .
- Если вам нужно прокомментировать целые блоки кода, используйте блок комментариев POD .
- , , ,