224 lines
8.6 KiB
Markdown
224 lines
8.6 KiB
Markdown
---
|
||
title: Revisión de Código
|
||
x-reviewed: true
|
||
...
|
||
|
||
Nuestros planes a corto plazo y necesidad de ayuda
|
||
==================================================
|
||
|
||
GNU Boot busca colaboradores para diversos trabajos, tanto simples como
|
||
técnicos.
|
||
|
||
Información
|
||
-----------
|
||
|
||
El nombre Libreboot tiene una larga historia en la comunidad del
|
||
software libre. La mayoría de sus apariciones estaban destinadas a hacer
|
||
referencia al software de arranque libre, y no hay forma de editar esas
|
||
apariciones para hacer referencia al software de arranque libre con un
|
||
nombre distinto. Por lo tanto, necesitamos la ayuda de la comunidad en
|
||
general para informar a la gente sobre la inclusión de software no-libre
|
||
en las versiones de Libreboot.
|
||
|
||
Otra forma de ayudar a GNU Boot y defender el software realmente libre
|
||
es cambiar las URL de la web de <libreboot.org> a
|
||
<gnu.org/software/gnuboot>, para asegurarse de que el software
|
||
mencionado sea software libre.
|
||
|
||
También puedes ayudar a nuestro proyecto informando a la gente sobre el
|
||
GNU Boot u otro software de arranque 100% libre.
|
||
|
||
Documentar y/o probar
|
||
---------------------
|
||
|
||
Necesitamos ayuda para revisar y arreglar este sitio web (que también
|
||
contiene la documentación). Muchas páginas se heredan de Libreboot y
|
||
pueden estar desactualizadas o ser específicas de Libreboot.
|
||
|
||
Además, también necesitamos ayuda para probar los lanzamientos y
|
||
probar/actualizar las instrucciones de instalación.
|
||
|
||
Actualmente tenemos una lista de las computadoras que aún no se han
|
||
probado en el [bug 64754](https://savannah.gnu.org/bugs/?64754).
|
||
|
||
En cuanto a informar lo que probó, puede abrir un nuevo bug o enviar un
|
||
correo a las lista de correo
|
||
[gnuboot](http://lists.gnu.org/mailman/listinfo/gnuboot) o
|
||
[bug-gnuboot](https:// listas.gnu.org/mailman/listinfo/bug-gnuboot).
|
||
|
||
Contribuciones técnicas
|
||
-----------------------
|
||
|
||
Actualmente, GNU Boot utiliza versiones viejas de software a
|
||
contracorriente (upstream) (como Coreboot, GRUB, etc.) y, por lo tanto,
|
||
es necesario actualizarlas. Los parches para esto deben enviarse a la
|
||
lista de correo
|
||
[gnuboot-patches](http://lists.gnu.org/mailman/listinfo/gnuboot-patches).
|
||
|
||
También tenemos un rastreador de errores en
|
||
https://savannah.gnu.org/bugs/?group=gnuboot que contiene una lista de
|
||
errores que deben corregirse.
|
||
|
||
Como contribuir
|
||
===============
|
||
|
||
Repositorios GNU Boot
|
||
---------------------
|
||
|
||
El desarrollo de GNU Boot se realiza utilizando el sistema de control de
|
||
versiones Git. Consulte la [documentación oficial de
|
||
Git](https://git-scm.com/doc) si no sabe cómo usar Git.
|
||
|
||
El repositorio principal de GNU Boot está en
|
||
<https://git.savannah.gnu.org/cgit/gnuboot.git>. También contiene el
|
||
sitio web/documentación y el código para construirlo.
|
||
|
||
GNU Boot también tiene dos repositorios adicionales: uno para
|
||
[presentaciones realizadas en
|
||
conferencias](https://git.savannah.gnu.org/cgit/gnuboot/presentations.git)
|
||
o para [duplicar el código fuente que ha
|
||
desaparecido](https://git.savannah.gnu.org/cgit/gnuboot/acpica.org-mirror.git).
|
||
|
||
Puede descargar cualquiera de estos repositorios, realizar los cambios
|
||
que desee y luego enviarlos siguiendo las instrucciones a continuación.
|
||
|
||
Probando tus modificaciones
|
||
---------------------------
|
||
|
||
Para contribuciones técnicas o para contribuir al sitio web, es posible
|
||
que necesite probar sus modificaciones.
|
||
|
||
Actualmente, esto requiere el uso de una distribución de GNU con Linux,
|
||
ya que la creación de GNU Boot o su sitio web en otros sistemas
|
||
operativos no está completamente probada.
|
||
|
||
Para obtener instrucciones sobre cómo compilar GNU Boot, puede consultar
|
||
las [instrucciones de compilación](docs/build/).
|
||
|
||
Sitio web
|
||
---------
|
||
|
||
El sitio web está en el código fuente de GNU Boot dentro del directorio
|
||
/site.
|
||
|
||
Actualmente está escrito en Markdown, específicamente la versión Pandoc
|
||
y las páginas HTML estáticas se generan con
|
||
[Untitled](https://untitled.vimuser.org/), un generador de sitios web
|
||
estáticos.
|
||
|
||
Su documentación se encuentra en el
|
||
[README](https://git.savannah.gnu.org/cgit/gnuboot.git/tree/website/README)
|
||
dentro del directorio de compilación del sitio web.
|
||
|
||
Nombre no requerido
|
||
-------------------
|
||
|
||
Muchos proyectos que utilizan licencias de software libre aceptan
|
||
contribuciones de cualquier persona, pero en muchos casos también
|
||
necesitan poder rastrear la tenencia de Derechos de Autor de las
|
||
contribuciones por varias razones.
|
||
|
||
Esto suele complicar las contribuciones anónimas o seudónimas, pero no
|
||
las hace imposibles.
|
||
|
||
Si desea contribuir de forma anónima o seudónima, la mejor manera es
|
||
contactarnos públicamente (por ejemplo, en nuestra lista de correo,
|
||
usando un correo y un nombre que use solo para eso) para que podamos
|
||
investigarlo e intentar encontrar formas que funcionen para GNU Boot,
|
||
pero también potencialmente para otros proyectos anteriores y de esta
|
||
manera le permitirá contribuir a una amplia variedad de proyectos bajo
|
||
licencias de software libre con mucha menos dificultad.
|
||
|
||
Tenga en cuenta que, en el caso de los parches, las contribuciones que
|
||
realiza se registran públicamente, en un repositorio Git al que todos
|
||
pueden acceder.
|
||
|
||
Y estas aportaciones incluyen un nombre, una dirección de correo
|
||
electrónico e incluso una fecha precisa en la que se realizó la
|
||
aportación. Es relativamente fácil cambiar el nombre y el correo
|
||
electrónico por los que desee, ya que el comando git commit tiene
|
||
opciones para eso.
|
||
|
||
Si haces eso, antes de enviar parches asegúrate de usar [git log
|
||
git\-\-pretty=fuller](https://git-scm.com/book/en/v2/Git-Basics-Viewing-the-Commit-History)
|
||
y [git show\-\-pretty=fuller](https://git-scm.com/docs/git-show) para
|
||
confirmar que utilizó el nombre y el correo electrónico correctos antes
|
||
de publicar los cambios.
|
||
|
||
Tenga en cuenta que incluso si hace eso, es posible que aún sea posible
|
||
vincular sus contribuciones a su identidad, por ejemplo con
|
||
[estilometría](https://media.ccc.de/v/28c3-4781-en-deceiving_authorship_detection),
|
||
mirando las conexiones de red si no usas [Tor](torproject.org), mirando
|
||
la hora/zona horaria de la contribución, etc.
|
||
|
||
Licencias
|
||
--------
|
||
|
||
Requerimos que todos los parches se envíen bajo una licencia libre:
|
||
<https://www.gnu.org/licenses/license-list.html>.
|
||
|
||
- Se recomienda encarecidamente la licencia pública general de GNU
|
||
versión 3. - Para la documentación, requerimos la licencia de
|
||
documentación libre GNU v1.3 o superior
|
||
|
||
*¡Siempre* declara una licencia sobre tu trabajo! No declarar una
|
||
licencia significa que se aplican las leyes de Derechos de Autor
|
||
restrictivas y predeterminadas, lo que haría que su trabajo no fuera
|
||
libre.
|
||
|
||
Generalmente se recomienda GNU/Linux como sistema operativo de elección
|
||
para el desarrollo de GNU Boot. Sin embargo, los sistemas operativos BSD
|
||
también arrancan en máquinas con GNU Boot.
|
||
|
||
Envía parches y contribuye
|
||
-------------------------
|
||
|
||
Puede enviar sus parches a la [lista de correo
|
||
gnuboot-patches](https://lists.gnu.org/mailman/listinfo/gnuboot-patches),
|
||
preferiblemente usando [git
|
||
send-email](https://git-scm.com/docs/git-send-email).
|
||
|
||
Una guía sencilla para configurar correctamente su instalación de Git
|
||
para enviar correos electrónicos ha sido creada por
|
||
[sourcehut](https://git-send-email.io/) o puede utilizar la [interfaz
|
||
sourcehut](https://man.sr.ht/git.sr.ht/#sending-patches-upstream) para
|
||
crear parches.
|
||
|
||
Tendrás que especificar la dirección de la lista de correo:
|
||
|
||
git config --local sendemail.to gnuboot-patches@gnu.org
|
||
|
||
Cierra también tus parches, que puedes configurar con:
|
||
|
||
git config format.signOff yes
|
||
|
||
Una vez que haya enviado su parche, los mantenedores de GNU Boot serán
|
||
notificados a través de la lista de correo y comenzarán a revisarlo.
|
||
|
||
Todos los parches que se agregan a GNU Boot requieren el acuerdo de dos
|
||
mantenedores. El acuerdo de mantenedor a menudo se indica con un texto
|
||
como este:
|
||
|
||
Acked-by: <nombre del mantenedor> <correo electrónico del mantenedor>.
|
||
|
||
En una respuesta (correo electrónico) del mantenedor indicado.
|
||
|
||
El acuerdo de los mantenedores sobre un parche no significa
|
||
necesariamente que haya un acuerdo sobre el orden en que se agregará.
|
||
Por lo tanto, los parches también pueden aterrizar temporalmente en una
|
||
rama 'gnuboot-next' y potencialmente reordenarse hasta que todos los
|
||
mantenedores de GNU Boot estén de acuerdo en *push* (empujar) todas las
|
||
confirmaciones en el orden elegido en la rama principal.
|
||
|
||
Esa rama 'gnuboot-next' también se puede utilizar cuando los
|
||
mantenedores de GNU Boot acuerdan fusionar los parches pero necesitan
|
||
esperar la aprobación del proyecto GNU, por ejemplo, si hay cuestiones
|
||
legales que también requieren la aprobación del Proyecto GNU.
|
||
|
||
Mantenedores
|
||
-----------
|
||
|
||
Adrien 'neox' Bourmault y Denis 'GNUtoo' Carikli son los actuales
|
||
mantenedores del proyecto GNU Boot. También revisarán los parches
|
||
enviados a la lista de correo.
|