Se recomienda seguir estas instrucciones al añadir problemas a las páginas de Problemas comunes. El uso de un formato estándar facilita la lectura y mejora la calidad de las páginas.
Metadatos en Bugzilla
Cuando añada un problema con informe en Bugzilla, por favor incluya la clave CommonBugs al informe, así como un enlace al ítem correspondiente de la página de Problemas comunes en el campo Whiteboard.
Problemas resueltos
Una vez resuelto el problema, añada la plantilla {{Common bugs update released/es}} con el enlace a la actualización (más abajo se dan los detalles). Si se trata de un problema de una versión previa al lanzamiento (Alfa o Beta), puede eliminar la entrada una vez salga el siguiente hito (Beta o Final) con la corrección. Para las versiones estables se debería mantener el ítem, pero pasándolo a la sección de Problemas resueltos.
Formato de cada ítem
Use la plantilla de problemas al inicio: genera un enlace al ítem, una cabecera y enlaces a Bugzilla. El formato es:
{{Common bugs issue/es|teclado-no42|El teclado deja de funcionar tras escribir 42|1234567|7654321}}
Esto es lo que ese código genera:
El teclado deja de funcionar tras escribir 42
enlace directo a este elemento - Bugzilla: #1234567 - Bugzilla: #7654321
Tenga en cuenta que el primer parámetro (teclado-no42 en el ejemplo) se usa como nombre para el enlace al ítem. Ponga algo corto y único, sin caracteres especiales, para conseguir enlaces limpios y sencillos.
Si hay una actualización que corrige el problema, incluya otra plantilla bajo la cabecera. Si la actualización está en el repositorio de pruebas updates-testing, use esta plantilla. Si es estable, use esta otra y lleve todo el problema a la sección de Problemas resueltos. En ambas plantillas el primer parámetro es el identificador de la actualización, que se puede encontrar en la página de la actualización en Bodhi. Es algo del estilo de FEDORA-2014-16304. Así que tendríamos:
{{Common bugs update testing/es|FEDORA-2014-16304}} {{Common bugs update released/es|FEDORA-2014-16304}}
La primera produce:
Y la segunda:
El instalador es un caso especial. Las actualizaciones normales no pueden corregir errores en el instalador antes de instalar, pero hay un mecanismo de actualización de las imágenes. Si hay una imagen de correcciones para el instalador, puede usar esta plantilla especial. Se le pasa de parámetro la URL de la imagen:
{{Common bugs update anaconda/es|https://dshea.fedorapeople.org/1170275.img}}
Esto es lo que se obtiene al usarla:
Después de todo eso, añada la descripción del problema.
Así que al final podría tener algo como:
{{Common bugs issue/es|teclado-no42|El teclado deja de funcionar tras escribir 42|1234567|7654321}} {{Common bugs update testing/es|FEDORA-2014-16304}} Debido a la alineación de los planetas, cuando se escribe
{{Key press|4}}{{Key press|2}} el teclado deja de funcionar,
haciendo inservible ese método de entrada hasta el siguiente reinicio.
Recomendamos no pulsar esas teclas seguidas (por ejemplo,
use en su lugar la secuencia {{Key press|4}}{{Key press|3}}
{{Key press|2}}{{Key press|Left}}{{Key press|Backspace}}{{Key press|Right}}),
así como tener disponibles otros métodos de entrada e incluso el
teclado en pantalla. Otra opción es modificar la posición de los planetas.
Y así es como quedaría:
El teclado deja de funcionar tras escribir 42
enlace directo a este elemento - Bugzilla: #1234567 - Bugzilla: #7654321
Debido a la alineación de los planetas, cuando se escribe 42 el teclado deja de funcionar, haciendo inservible ese método de entrada hasta el siguiente reinicio. Recomendamos no pulsar esas teclas seguidas (por ejemplo, use en su lugar la secuencia 43 2←← Backspace→), así como tener disponibles otros métodos de entrada e incluso el teclado en pantalla. Otra opción es modificar la posición de los planetas.
Herramienta commonbugs-update
Hay una herramienta para añadir las notas de 'actualización disponible' a problemas ya existentes en las páginas de problemas comunes: commonbugs-update
. Puede encontrarla en el repositorio qa-misc:
git clone https://pagure.io/fedora-qa/qa-misc.git
Ejecútela con:
./commonbugs-update NN
donde NN es el número de lanzamiento cuya página quiere actualizar.