Contribuir a Notas de Publicación

Equipo de Documentación de Fedora <https://discussion.fedoraproject.org/tag/docs> v0.0.1, 2022-09-26

Esta sección describe como contribuir con las Notas de Publicación de Fedora. Antes de iniciar siguiendo este procedimiento, asegúrese que completa todos los requisitos listados en Prerequisitos.

El proceso de contribución de Notificaciones de Publicación está en una página separada es diferente desde cualquier otra documentación de Fedora. Si está interesado en contribuir a cualquier otro documento, consulte la página apropiada.

Las Notas de Lanzamiento son únicas en eso, a diferencia de toda la documentación, son escrita completamente y cercanas desde cero para cada nuevo lanzamiento, mientras que otros documentos son conservador a lo largo de las liberaciones, solo con actualizaciones. Esto significa que algunas partes del procedimiento mencionado, como la rama de git son utilizados o la planificación, cambia con cada liberación nueva. Antes de iniciar a escribir las notas de liberación, consulte el #docs tag on Fedora Discussion, específicamente la barra lateral a la derecha. Encontrará allí la información actual.

Como contribuir a las Notas de Publicación de Fedora

  1. Compruebe la barra lateral en el enlace Fedora Discussion, y note la información proporcionada: Liberación, planificación, rama, y enlace al listado de incidencias relevantes.

  2. Tome uno o más incidencias desde el listado de incidencias abiertas y desasignadas para la publicación la cual desea contribuir.

  3. Abra cada incidencia que tomó, y pulse el botón Tomar a la derecha para reclamarlo.

    Si reclama una incidencia, puede más tarde encontrar que no tiene tiempo para finalizarla, retírese del asunto TPCP tan que alguno más pueda tomarla.

  4. Busca información sobre tu problema. Muchos ya contienen mucha información, especialmente en el enlace a la wiki. Si necesitas más, averigua quién es el responsable del cambio (también aparece en la página wiki de la incidencia) y menciónelo en los comentarios o habla con él por IRC/Matrix o por correo electrónico. Recuerda que siempre es mejor investigar antes de preguntar. Ten en cuenta que es posible que no siempre puedas contactar con el responsable en un plazo razonable; en ese caso, haz lo posible; si algo sale mal, siempre podemos actualizarlo más adelante.

  5. Escribe una nota de lanzamiento sobre el problema. Si no estás seguro de cómo se ve exactamente una nota de lanzamiento, consulta el previous releases para inspirarte. No queremos textos largos ni excesivamente técnicos; las notas de lanzamiento generalmente están diseñadas para destacar cambios, no para explicar cómo usar algo.

  6. Ahora el flujo de trabajo difiere basándose en sus permisos de Pagure y sus habilidades técnicas:

    • Si conoce como utilizar git y ASCIIDoc, escriba la nota de liberación y envía una solicitud de subida frente al repositorio principal. Asegúrese que abra la solicitud de subida con la rama correcta, no main; consulte el primer paso de este procedimiento para información. (La rama main solo se utiliza como una plantilla para cada liberación nueva, por tanto solo contiene una estructura vacío y algunas páginas que no varían entre liberaciones). Su contribución iría en uno de los archivos en modules/release-notes/pages/, las cuales exactamente dependen en el contenido de los cambios que está documentando.

Si no puede ver la sección donde añadió su contribución, asegúrese que esté incluido en la tabla de contenido en modules/release-notes/nav.adoc.

+ * Si suena como algarabía para usted, está bien. Tan solo añada un comentario con su texto en la incidencia, y alguno lo marcará y lo añadirá al final del documento.

Repita lo de arriba para muchas incidencias como quiera.

Want to help? Learn how to contribute to Fedora Docs ›