La lista de tareas pendientes para la documentación

Aquí presentamos temas en los que trabajar para la documentación de usuario.

Durante el PBF proporcionaremos una hoja de cálculo con todos los temas en los que puede trabajar. Puede poner su nombre en esa hoja detrás de un tema en el que esté trabajando, para evitar el trabajo duplicado.

Puede encontrar una lista detallada en https://github.com/joomla/documentation/issues. Allí también puede encontrar debates sobre un tema e información de contexto. También puede marcar allí que está trabajando en un artículo específico, para evitar que otra persona trabaje en el mismo tema.

En el punto de mira: páginas de resumen

Cuando observe las explicaciones en la guía de usuario, verá que están agrupadas por tema. Cada tema tiene un artículo de resumen, que le informa sobre qué tipo de información se puede encontrar en las páginas subyacentes. Por ejemplo, bajo Artículos encontrará 25 páginas que explican todo tipo de cosas relacionadas con los artículos. En la página de resumen esas páginas se presentan de manera estructurada.

A continuación encontrará una lista de páginas de resumen que faltan. Cuantos más artículos haya bajo esa página de resumen, mayor es la necesidad de una buena página de resumen.

En el punto de mira: tutoriales sobre la creación de sitios

Por el momento nos centraremos en tutoriales sobre la creación de sitios. Guías paso a paso que muestran todos los conceptos que se utilizan para construir un sitio con Joomla.

Cómo están estructurados esos tutoriales de creación de sitios y qué artículos existentes del manual de usuario puede utilizar para ello se puede encontrar en esta hoja de cálculo (trabajo en curso).

Puede encontrar más información en todos los subelementos de este asunto: ... pendiente...

Vea el menú lateral izquierdo en la página de Tutoriales. Allí puede ver cómo puede verse un tutorial.

Acerca de los tutoriales

Un tutorial casi nunca está completo. Solo muestra una manera de hacer algo, no todas las posibilidades alternativas de hacerlo.
El objetivo principal es mostrar algunos conceptos que se quieren enseñar. Sin explicaciones largas. Un tutorial es aprender haciendo.
El tutorial ofrece una serie de pasos que el lector puede repetir, lo que conduce a un resultado reproducible. Sin embargo, el camino es más importante que el resultado.
orden fijo:
- Comience con un resumen de los requisitos previos: qué tutoriales se deben hacer antes de hacer este.
- Luego un resumen de qué trata este tutorial (describiendo brevemente el ejemplo).
- Luego los pasos a seguir
- Termine con una conclusión: resumen de los conceptos tratados.

Otros temas en los que podría trabajar:

Campos personalizados.
Guías prácticas con mod_articles.
Tutorial: Añadir un módulo al Panel de inicio.
Modificaciones de plantilla.
Artículos de revista útiles.

Campos personalizados

Necesario:

un tutorial que explique cómo utilizar los campos personalizados; ahora: https://docs-core.sandbox.joomla.org/user-manual/fields/fields-fields-and-field-groups
De todos los artículos que actualmente están bajo "campos" hay 4 artículos generales (campos y grupos de campo, parámetros de campo, sitios multiidioma y modificaciones de plantilla). Están al mismo nivel que los 15 tipos de campos personalizados y un artículo sobre un campo personalizado especial: subformulario. ¿Puede idear una estructura mejor en lugar de poner todos esos artículos al mismo nivel? si necesita una capa más profunda, no se olvide de la página de resumen.
una guía práctica sobre cómo repetir campos personalizados (usando un subformulario).
ejemplo de uso de subformularios anidados en campos personalizados (nuevo desde la versión 5.2).
una referencia (resumen) de todos los campos personalizados + una breve descripción.
tutorial sobre modificaciones de plantilla. consulte https://docs-core.sandbox.joomla.org/user-manual/fields/fields-adding-custom-fields-overrides

Consulte la serie sobre campos personalizados de Marc Dechèvre en la Revista: