Salta al contingut

Col·laboreu-hi


Voleu fer encara millor el ghostwriter? Llegiu les seccions següents per a veure com podeu col·laborar-hi.

Informes d'errors

Heu trobat un error? Si us plau, informeu-lo en el seguidor d'incidències de KDE. No oblideu seguir les directrius d'informació d'incidències! El més important, no oblideu incloure el número de versió del ghostwriter que esteu utilitzant.

Avís: Si no es proporciona la informació requerida a la plantilla d'informe d'error, l'informe d'error es tancarà automàticament.

Triatge d'errors

Podeu ajudar a triar problemes en el [seguidor d'errors][KDE.Bugs] reproduint errors i obtenint més informació dels informadors d'errors per a ajudar a centrar el problema. També agrairem tancar els problemes duplicats i altres endreços. Per a més informació, vegeu les directrius de triatge d'error.

Característiques noves i correccions d'errors

Sabeu com codificar? Seguiu aquests passos:

  1. Obriu una incidència amb la vostra característica o error al seguidor d'incidències de KDE.
    Nota: Aquest pas és necessari per a assegurar que la nova característica compleix els objectius del projecte o que l'error no és realment una característica. També voldreu coordinar quines àrees de codi actualitzareu per a evitar conflictes de fusió en cas que algú altre treballi també en aquesta mateixa àrea de codi.
  2. Després de debatre el problema nou, codifiqueu la funcionalitat o solució d'error. Seguiu la guia d'estil de codificació dels Frameworks de KDE. Important: Si us plau, manteniu el vostre codi centrat en el problema que s'està tractant. Els canvis no relacionats amb el codi que pertanyen a problemes/sol·licituds de fusió separades no faciliten la revisió ni les proves de codi.
  3. Envieu una petició de publicació contra la branca mestra amb les actualitzacions del codi.
    Important: Aixafeu les vostres comissions en el «git» abans d'enviar la petició de publicació!
  4. Espereu una revisió breu de codi i almenys dos altres voluntaris per a provar la vostra funcionalitat o correcció d'error.
  5. Feu actualitzacions de la vostra petició de publicació a mesura que rebeu comentaris.
  6. Una vegada que la vostra petició de publicació s'aprovi per almenys dos altres provadors voluntaris, aquesta petició de publicació es fusionarà.

Revisions de codi

Sabeu com codificar i donar una ullada als detalls? Feu-vos voluntari per a revisar entre iguals les peticions de fusió noves!

  1. Cerqueu una petició de fusió nova, i afegiu un comentari dient que sou voluntari per a revisar-la.
  2. Envieu comentaris de revisió de codi.
  3. Espereu actualitzacions a la petició de fusió (si calen).
  4. Continueu proporcionant comentaris fins que confieu que el codi sigui raonable.
  5. Deixeu un comentari amb l'aprovació de la petició de fusió.
  6. Una vegada que almenys dos provadors voluntaris presentin la seva aprovació, la petició de fusió es fusionarà.

Aquí hi ha alguns consells de què cercar en les revisions de codi:

  • El codi enviat segueix la guia d'estil de codificació dels Frameworks de KDE?
  • Es pot llegir el codi, amb comentaris que expliquin qualsevol línia no òbvia?
  • El codi és «pessimista»? En altres paraules, comprova si hi ha valors no vàlids abans d'utilitzar-los i gestionar possibles condicions d'error?
  • S'han posat entre parèntesis les comparacions o expressions múltiples dins de les declaracions if per a evitar accidents amb l'ordre de les operacions? Exemples:
    // Incorrecte
    if (a == b || c > d);
    
    // Correcte
    if ((a == b) || (c > d));
    
  • Hi ha literals al costat esquerre de l'operador == per a evitar que un error tipogràfic amb l'operador = escapi de l'avís del compilador? Exemples:
    // Incorrecte
    if (variable == 1);
    
    //         Motiu: Què passa si hi ha un error tipogràfic? El compilador no el detectarà!
    if (variable = 1); // Vaja!
    // Correcte
    if (1 == variable);
    
    //         Motiu: Aquesta vegada el compilador detectarà l'error tipogràfic.
    if (1 = variable); // Vaja!
    

Proves

Voluntari per a revisar el codi i provar noves funcionalitats i correccions d'errors! Seguiu aquests passos:

  1. Cerqueu una petició de fusió nova, i afegiu un comentari que sou voluntari per a provar-la.
  2. Construïu la petició de fusió a la vostra plataforma.
  3. Proveu la funcionalitat/correcció d'error i intenteu trencar-la!
  4. Proporcioneu comentaris sobre els resultats de la prova a la petició de fusió.
  5. Espereu actualitzacions a la petició de fusió (si calen).
  6. Continueu provant i proporcionant comentaris fins que confieu que el codi funciona.
  7. Deixeu un comentari amb l'aprovació de la petició de fusió.
  8. Una vegada que un altre provador voluntari enviï la seva aprovació, la petició de fusió serà acceptada.

Traduccions

Considereu unir-vos a l'equip de traduccions del KDE per a traduir les vostres aplicacions preferides a altres idiomes.

Suport tècnic

Teniu coneixements sobre el Linux o la construcció en el MacOS? Sabeu com arreglar aquesta incidència que altres continuen tenint? S'agrairan molt les respostes a preguntes d'usuaris i la resolució de problemes en el sistema de seguiment d'errors de KDE!