Wikimore

Esta breve guía estilo TLDR está dirigida a desarrolladores que tienen algo de experiencia con Git, y quieren empezar con Gerrit para el desarrollo de MediaWiki. Para un tutorial con explicaciones detalladas, lee Gerrit/Tutorial.

Requisitos previos

Instala Git y git-review .
Crea una nueva clave SSH para usar con Wikimedia Gerrit:
- Ejecuta lo siguiente desde tu terminal, sustituyendo tu dirección de correo electrónico:
```
ssh-keygen -t ed25519 -C "your_email@example.com"
```
- Cuando aparezca la indicación "Enter a file in which to save the key" (Introduce un archivo donde guardar la clave), puedes pulsar Enter para aceptar la ubicación predeterminada si esta es tu primera clave SSH. De lo contrario, personalízalo a algo como /Users/YOUR_NAME/.ssh/id_wikimedia_gerrit
- En la indicación "Enter passphrase:" (Introduce una frase de contraseña:), elige una frase de contraseña segura. Normalmente tendrás que hacerlo la primera vez en un día determinado cuando extraigas o envíes solicitudes de cambio.
Crea una cuenta de desarrollador de Wikimedia. Luego, inicia sesión en gerrit.wikimedia.org y añade tu clave pública a tu cuenta. La clave pública es el contenido de /Users/you/.ssh/id_wikimedia_gerrit.pub
Configura Git para establecer tu dirección de correo electrónico, nombre y nombre de usuario SSH.

Obtén el código

Clona el repositorio usando el comando que se encuentra en el navegador de repositorios (p. ej., https://gerrit.wikimedia.org/g/mediawiki/core). Puedes encontrarlos en la lista, o desde la ficha informativa de la extensión en mediawiki.org. Los repositorios clonados con mayor frecuencia son:

Núcleo de MediaWiki: git clone https://gerrit.wikimedia.org/r/mediawiki/core.git mediawiki

Extensiones de MediaWiki: git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/<extensión>.git

Apariencias de MediaWiki: git clone https://gerrit.wikimedia.org/r/mediawiki/skins/<apariencia>.git

Escribe tu parche

Inicia tu rama desde la última rama de producción:

mediawiki$ git checkout master
mediawiki$ git pull
mediawiki$ git checkout -b nombre-de-rama-significativo

NOTA: En algunos casos, la rama de producción puede llamarse "production" o "main" y requerir un comando checkout modificado, como:

mediawiki$ git checkout production

mediawiki$ git checkout main

Ahora puedes editar el código para realizar y probar tus cambios. Una vez que estés satisfecho y el código esté listo para operar:

git commit --all Cuando trabajes con Gerrit, haz esto solo una vez por rama. Para corregir errores, usa git commit --amend.
git show Revisa tu parche para confirmar lo que nos estás enviando. Pulsa "q" para salir.
git review Esto sube los cambios a Gerrit y crea una solicitud de cambio. Si recibes un error y habías instalado previamente el programa antiguo "gerrit-tools", instala "git-review" en su lugar.

Te recomendamos invitar a uno o dos mantenedores para que actúen como revisores de tu cambio. Después de crear la solicitud de cambio, el comando git review habrá impreso la URL de tu solicitud de cambio. También puedes encontrar tus cambios a través de tu panel de Gerrit. En la página de cambio, bajo "Reviewers" (Revisores), haz clic en el botón de lápiz "Add Reviewer" (Añadir revisor). Escribe el nombre de un revisor en el recuadro de entrada. Si no sabes a quién invitar para la revisión, consulta la lista de mantenedores del componente que has modificado, o pregunta en IRC (#mediawiki ^connect).

Actualiza tu parche

Si un revisor te pide que hagas cambios, modifica tu "commit" (confirmación de cambios) de la siguiente manera:

git review -d ID_de_cambio p. ej. 1234 en https://gerrit.wikimedia.org/r/1234. Esto descarga y revisa la solicitud de cambio desde Gerrit.
Edita los archivos fuente para realizar tus cambios.
git commit --all --amend Puedes ejecutar esto tantas veces como quieras. Al editar el mensaje del "commit", deja la línea "Change-Id" (ID-de-cambio) intacta.
git review Esto actualiza tu solicitud de cambio en Gerrit, con una nueva versión del conjunto de parches que refleja tu cambio, y notifica automáticamente a los revisores suscritos.

Véase también

Intenta cumplir nuestras directrices de mensajes de confirmación
Véase también Obtener revisiones

Category:Gerrit/es