Como hacer contribuciones casuales
Para realizar los cambios en la página Docs hospedada en GitLab, tiene un editor web incrustado que hace su primera contribución más fáciles que nunca. Comienza editando documentación en GitLab Web IDE que puede lanzar en una pulsación. No necesita permisos especiales o acceso de escritura para el proyecto original.
-
No hay ninguna necesitad de instalar apps o clonar repos en su equipo local, o ejecutar instrucciones de Git en la terminal.
-
No hay ningún riesgo de romper algo.
-
Esta guía es para el repo hospedado por GitLab.
Como editar documento con el IDE web
Paso 1. Seleccione una página a editar
-
Vaya a la página Docs que desea editar.
-
Navegue a la cima derecha y ubique tres botones.
-
Pulse el botón del medio en editar la página para hacer correcciones.
| El botón izquierdo avanza al historial de versión de la página de Docs abierta como una referencia. El botón izquierdo informar un problema está cuando puede informar cualquier cambio o actualización requerida. |
|
|
-
Acceda a su cuenta existente de GitLab
-
Utilice el enlace SAML para enlazar su cuenta a FAS
-
Será redirigido y pedida sus credenciales FAS si son necesarias
-
Permisos otorgados a Fedora
Crea una cuenta si no desde una aún (consulte la imagen a continuación).
|
| Esta guía del contribuidor camina a lo largo del IDE Web, introducido en la publicación GitLab 15.7. La guía además refleja un cambio reciente sobre how to update fork. |
Paso 2. Cree su proyecto (copiar)
Pulse el botón Abrir en IDE Web. ALternativamente, presione . (punto) en el teclado para lanzar el IDE Web.
|
Bifurcar un proyecto la primera vez
Pulse sobre el botón Bifurcar.
El botón Fork aparece solo la primera vez que contribuya al repositorio de una página de Docs dada. Si está contribuyendo al proyecto Fedora por primera vez y no tiene acceso de escritura para el repositorio que quiere contribuir, necesita bifurcar un proyecto.
Una bifurcación es una copia personal del repositorio, la cual crea en su espacio de nombre.
|
Si ha bifurcado un proyecto antes
Si tiene un proyecto bifurcado, será seguido automáticamente para el siguiente paso sin el botón Fork.
Si no lanza un IDE web desde su bifurcación, el botón edit fork in Web IDE aparecerá en ves del botón Open in Web IDE. Después será solicitada a go to fork y la casilla para su bifurcación.
-
Ir a su proyecto bifurcado.
-
Marque el estado de su bifurcación cerca del botón del Web IDE.
Si su bifurcación muestra Up to date with he upstream repository, vaya al paso 3 en el Web IDE.
Si su bifurcación está detrás del upstream , verás un texto en la interfaz de usuario que indica qué tan atrás se encuentra su bifurcación.
-
Pulse el botón Actualizar rama.
-
La bifurcación exhibirá Up to date with the upstream repository
-
El botón Update fork desaparece tras bifurcación está actualizada
Paso 3. Crea una rama nueva (versión)
En su proyecto bifurcado, cree una rama nueva y cambia a ésta siguiente los pasos a continuación.
-
En la barra de estado debajo en la esquina izquierda inferior, pulse el nombre de la rama actual (normalmente main).
-
Desde el listado del menú desplegable, seleccione Crear en rama nueva…
-
Teclee el nombre de la rama que está especificada a una tarea.
-
Pulse Intro.
-
Marque para una rama nueva. Pulse Yes a la siguiente caja aparecida.
¿Está seguro que desea hacer el checkout <nombre-rama>? Cualquier cambio se perderá.
Paso 4. Edite y guarde los cambios
Ahora, para hacer los cambios necesarios en el IDE Web. Para escribir con consistencia, refiera a La guía de estilo de docs
Una vez que haya terminado, seleccione el botón del control de fuente y pulse el archivo debajo de changes bajo el botón Commit & Push) para ver sus cambios.
Teclee un mensaje commit y pulse Commit & Push. Pulse No para que ejecutar a la rama existente.
Paso 5. Crear Petición de Unión (MR)
En la esquina inferior derecha, encontrará estas tres opciones; create MR, Go to project, Continue working.
-
Pulse Crear MR para crear solicitud de unión.
-
Edite el título y la descripción de la página.
-
Arrastre al botón azul Crear solicitud de unión y púlselo.
| Go to project option is suitable when you made small commits by stage and want to squash them into one. Continue working is when you want to make smaller commits by sub tasks. If you select Create MR, the UI will navigate to merge request. |
If merge request is successful, you will see the following result in the lower-middle of merge request.
Ready to merge by members who can write to the target branch.
Paso 6. Revisar
Your request will be reviewed by Docs team. You will expect one of the following actions.
-
Reviewers ask you to revise your changes
-
Aprobar
-
Rechazar y cerrar MR con motivo
Whatever the case it is, MR comments facilitate collaboration between contributors and reviewers. Everyone can learn from those comments and corrections.
Once your MR is approved, the process is complete.
¡Gracias por su contribución!
Want to help? Learn how to contribute to Fedora Docs ›