Colaborar

¿Está interesado en hacer que ghostwriter sea todavía mejor? Lea las secciones siguientes para saber cómo colaborar.

Informes de fallos

¿Ha encontrado un fallo? Notifíquelo en el sistema de seguimiento de fallos de KDE. No se olvide de seguir las directrices de notificación de fallos. Y lo más importante: no se olvide de incluir el número de versión de ghostwriter que está usando.

Advertencia: Si no puede proporcionar la información requerida en la plantilla del informe de error, dicho informe se cerrará automáticamente.

Selección de fallos

Puede ayudar a seleccionar fallos en el sistema de seguimiento de fallos volviéndolos a reproducir y obteniendo más información de quienes los han notificado para delimitar dónde puede estar el problema. El cierre de problemas duplicados y otras tareas de limpieza también son de agradecer. Para más información, consulte las directrices de selección de fallos.

Nuevas funcionalidades y corrección de errores

¿Sabe programar? Siga estos pasos:

1. Cree un informe para su funcionalidad o error en el sistema de seguimiento de fallos de KDE.
   Nota: Este paso es necesario para garantizar que la nueva característica cumpla con los objetivos del proyecto o que el error no sea realmente una característica. También querrá coordinar las áreas de código que va a actualizar para evitar conflictos de fusión en caso de que alguien más también esté trabajando en esa misma área de código.
2. Después de discutir su nuevo problema, programe su función o corrección del error. Siga la guía de estilo de programación de KDE Frameworks. Importante: mantenga su código enfocado en el problema en cuestión. Los cambios en el código no relacionados pertenecen a otras peticiones de fusión o errores para facilitar la revisión y la prueba del código.
3. Envíe una solicitud de incorporación de cambios en la rama principal con las actualizaciones de su código.
   Importante: Por favor, combine sus commits en git antes de enviar la solicitud de incorporación.
4. Espere una breve revisión del código y a que al menos otros dos voluntarios prueben su funcionalidad o corrección de error.
5. Actualice su solicitud de incorporación a medida que reciba sugerencias.
6. Una vez que su solicitud de incorporación haya sido aprobada por al menos otros dos probadores voluntarios, se realizará su fusión.

Revisiones de código

¿Sabe programar y tiene buen ojo para los detalles? ¡Hágase voluntario para la revisión por pares de nuevas solicitudes de fusión!

1. Busque una nueva solicitud de fusión y añada un comentario ofreciéndose como voluntario para revisarla.
2. Envíe comentarios de revisión de código.
3. Espere las actualizaciones de la solicitud de fusión (si es necesario).
4. Continúe proporcionando comentarios hasta que esté seguro de que el código es sólido.
5. Deje un comentario con su aprobación de la solicitud de fusión.
6. En cuanto haya un mínimo de dos probadores voluntarios que hayan dado su aprobación, la solicitud de fusión se hará efectiva.

Estos son algunos consejos sobre lo que tiene que buscar en las revisiones de código:

• ¿El código propuesto sigue la guía de estilo de programación de KDE Frameworks?
• ¿Es el código legible, con comentarios que explican las líneas que no resultan obvias?
• ¿El código es «pesimista»? En otras palabras, ¿comprueba si hay valores no válidos antes de usarlos y maneja las posibles condiciones de error?
• ¿Están entre paréntesis las comparaciones o sentencias múltiples dentro de las sentencias if para prevenir accidentes con el orden de las operaciones? Por ejemplo:

  // Incorrecto
  if (a == b || c > d);
  
  // Correcto
  if ((a == b) || (c > d));
  

• ¿Hay literales en el lado izquierdo del operador == para evitar que un error tipográfico con el operador = escape al aviso del compilador? Por ejemplo:

  // Incorrecto
  if (variable == 1);
  
  //         Motivo: ¿Qué pasa si hay un error tipográfico? ¡El compilador no se dará cuenta!
  if (variable = 1); // ¡Ups!
  // Correcto
  if (1 == variable);
  
  //         Motivo: Esta vez, el compilador se dará cuenta del error tipográfico.
  if (1 = variable); // ¡Ups!
  

Pruebas

¡Ofrézcase como voluntario para revisar código y probar nuevas funciones y correcciones de errores! Siga estos pasos:

1. Busque una nueva solicitud de fusión y añada un comentario ofreciéndose como voluntario para probarla.
2. Compile la solicitud de fusión en su plataforma.
3. Pruebe la funcionalidad o corrección de error y ¡trate de hacer que falle!
4. Proporcione comentarios sobre los resultados de las pruebas en la solicitud de fusión.
5. Espere las actualizaciones de la solicitud de fusión (si es necesario).
6. Continúe probando y proporcionando comentarios hasta que esté seguro de que el código funciona correctamente.
7. Deje un comentario con su aprobación de la solicitud de fusión.
8. Una vez que otro probador voluntario envíe su aprobación, la solicitud de fusión será aceptada.

Traducciones

Considere unirse al equipo de traducciones de KDE para traducir sus aplicaciones favoritas a otros idiomas.

Asistencia técnica

¿Tiene conocimientos sobre Linux o compilación en MacOS? ¿Sabe cómo solucionar ese problema que otros siguen teniendo? ¡Apreciaremos mucho sus respuestas a las preguntas de los usuarios y la resolución de problemas en el sistema de seguimiento de fallos de KDE!