Como editar archivos en la Interfaz Web de Pagure

Hanku Lee Version F33 and newer Last review: 2023-04-18

Esta sección describe como contribuir a la documentación existente – esto es, documentación que ya ha sido publicada en el sitio web. Antes de empezar con este procedimiento compruebe que cumple todos los requisitos listados en Requisitos previos.

Si está interesado en contribuir en las Notas a la Versión, vea la página apropiada.

Cada página de Documentos Fedora incluye un enlace "Editar esta Página" en la parte superior. Para simples actualizaciones, los cambios pueden ser presentados directamente desde la interfaz web Pagure. Para ediciones más grandes o más complejas, debería preparar y probar sus cambios fuera de línea antes de presentarlos.

Editar en línea en Pagure

  1. Pulse el enlace "Editar esta Página" para cargar la fuente de documentación. Será llevado al repositorio con el contenido adecuando en Pagure.

  2. En la parte superior del listado de fuentes en el lado derecho, pulse "Bifurcar y Editar". (Si ya ha bifurcado el repositorio, este botón estará etiquetado "Editar en su bifurcación" y puede saltar al siguiente paso.)

    1. Si todavía no ha accedido a Pagure, se le pedirán sus credenciales.

    2. Espere a que la operación termine. Puede necesitar refrescar la página puesto que no siempre se hace automáticamente cuando se ha hecho el proceso.

  3. Una vez que se ha cargado el archivo en su bifurcación, haga los cambios necesarios en su contenido, confírmelos en su bifurcación y prepare una solicitud de extracción (PR).

    1. Cada PR debe ser enviada desde su propia rama en su repositorio. Bajo el encabezado "Branch" de la interfaz de confirmación, seleccione "New branch" y dele a la rama un nombre único corto.

    2. Complete el formulario de mensaje de confirmación.

    3. Pulse "Confirmar cambios" para crear la rama y guardar estos cambios en su bifurcación.

  4. Una vez que se guarda la confirmación, la página se refrescará con una lista de Confirmaciones de su bifurcación.

  5. Para incluir cambios adicionales relacionados, repita el proceso y confírmelos en la misma rama.

  6. Cuando este preparado, pulse "Crear una solicitud de extracción" y rellene el formulario de PR para enviar su rama al repositorio ascendente.

Consejos de confirmación de git

  • Cuando dé nombre a su rama, utilice solo letras ASCII, dígitos, guiones (-) y guiones bajos (_). El nombre puede contener, pero no empezar ni terminar con, puntos (.). Los espacios, los puntos dobles (..) y la mayoría de la otra puntuación no está permitida.

  • El título de la confirmación es como se identificará su edición en el registro del repositorio de la página. El título sugerido, "Update pathname",, es suficiente para ediciones pequeñas. Para algún consejo sobre como escribir buenos mensajes de confirmación, vea commit.style by Tim Pope (autor de vim).

  • Use el campo "Commit Description" ("Descripción de la Confirmación") para proporcionar detalles adicionales si en necesario, pero que sean cortos. Tendrá la oportunidad de explicar o debatir sus cambios cuando envíe su PR.

Edición fuera de línea

  1. Pulse el enlace "Edit this Page" ("Editar esta Página") para cargar la fuente de documentación. Se le llevará al repositorio de contenido apropiado en Pagure. Una vez que ha localizado el repositorio correcto, haga una bifurcación si no lo ha hecho ya:

    1. En la esquina superior derecha, pulse Fork (Bifurcación).

    2. Si todavía no ha accedido a Pagure, se le pedirán sus credenciales.

    3. Espere a que la operación termine. Puede que necesite refrescar la página puesto que no siemre se actualiza automáticamente cuando el proceso se ha hecho.

    4. Clone su bifurcación.

  2. Consulte una nueva rama y añada sus contribuciones.

  3. Si ha añadido nuevos archivos, compruebe que están incluidos en un lugar razonable en el archivo de configuración ,nav.adoc del repositorio

  4. Construya localmente y asegúrese de que todo se ve como espera. Vea instrucciones en Construir una vista previa local.

  5. Una vez termine, confirme los cambios y envíelos a su bifurcación.

  6. Use Pagure para hacer peticiones de extracción a la rama maestra del repositorio principal.

Administrar sus peticiones de extracción

Alguien verá su petición de extracción y la fusionará o le proporcionara comentarios si hay algo que deba cambiar. Trabaje con las persona que comentan para asegurarse de que sus contribuciones estén a la altura de los estándares.

Si nadie reacciona su petición de extracción en varios días, intente mencionarlo en una de las reuniones semanales, el canal Matrix (#docs en Fedora Chat) o la lista de correo.

Sus cambios aparecerán en línea en algún momento después de que se fusione la solicitud de extracción. El sitio se actualiza cada hora. Si sus cambios no aparecen en línea dentro de las 24 horas después de que su solicitud de extracción haya sido fusionada, contacte con asamalik (Adam Šamalík) en el canal IRC y pregunte sobre ello.

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