Salta al contingut

Col·laboreu-hi


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

Informes d'error

Heu trobat un error? Informeu-ne 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ó de 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 del triatge d'errors.

Característiques noves i correccions d'errors

Sabeu com codificar? Seguiu estos passos:

  1. Obriu una incidència amb la vostra característica o error al seguidor d'incidències de KDE.
    Nota: Este pas és necessari per a assegurar que la nova característica complix 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 treballe també en esta mateixa àrea de codi.
  2. Després de debatre el problema nou, codifiqueu la característica o solució d'error. Seguiu la guia d'estil de codificació dels Frameworks de KDE. Important: Per favor, 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: Xafeu les vostres comissions en «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 característica 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'aprove per almenys dos altres provadors voluntaris, esta 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. Busqueu 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 siga raonable.
  5. Deixeu un comentari amb l'aprovació de la petició de fusió.
  6. Una vegada que almenys dos provadors voluntaris presenten la seua aprovació, la petició de fusió es fusionarà.

Ací hi ha alguns consells de què buscar en les revisions de codi:

  • El codi enviat seguix la guia d'estil de codificació dels Frameworks de KDE?
  • Es pot llegir el codi, amb comentaris que expliquen 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 en el costat esquerre de l'operador == per a evitar que un error tipogràfic amb l'operador = escape 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: Esta vegada el compilador detectarà l'error tipogràfic.
    if (1 = variable); // Vaja!
    

Proves

Voluntari per a revisar el codi i provar característiques noves i correccions d'errors! Seguiu estos passos:

  1. Busqueu 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 característica/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 envie la seua aprovació, la petició de fusió serà acceptada.

Traduccions

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

Suport tècnic

Teniu coneixements sobre Linux o la construcció a MacOS? Sabeu com arreglar esta 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!