Documentation
Alcance del tema
Buscar..
Introducción
Característica del lenguaje Temas
Una división natural es simplemente hacer un tema para cada característica del idioma. Por ejemplo, Python tiene:
- Las clases
- Funciones
- Generadores
- Decoradores
- . . .
En el lado negativo, las características pueden ser bastante complicadas y es fácil dar con muchos más ejemplos de los que tiene sentido para una sola página. Las clases tienen 16 ejemplos, por ejemplo. Algunos de ellos probablemente podrían moverse a otros temas de características, como Herencia, Propiedades, Métodos, etc.
Bolsa de agarre temas
Algunos temas son ejemplos sueltos asociados a un tema, como las características de C # 6.0 y las fallas comunes . En general, este estilo de tema ha sido desalentado ya que los ejemplos por tema fueron limitados ya que no hay un lugar natural para dejar de agregar contenido.
Probablemente sea mejor mover los ejemplos a otro tema (quizás para las características del idioma ). No he visto esto hecho, pero es posible que estos temas se puedan convertir en un metadema que incluya uno o dos ejemplos que consistan principalmente en enlaces a otros temas o ejemplos:
Consejos y trucos de Perl
- ¡No analices XML con una expresión regular! Utilice un módulo de análisis XML .
- Si necesita comentar bloques completos de código, use un bloque de comentarios POD .
- . . .