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:
- 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. - 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.
- 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ó! - Espereu una revisió breu de codi i almenys dos altres voluntaris per a provar la vostra funcionalitat o correcció d'error.
- Feu actualitzacions de la vostra petició de publicació a mesura que rebeu comentaris.
- 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!
- Cerqueu una petició de fusió nova, i afegiu un comentari dient que sou voluntari per a revisar-la.
- Envieu comentaris de revisió de codi.
- Espereu actualitzacions a la petició de fusió (si calen).
- Continueu proporcionant comentaris fins que confieu que el codi sigui raonable.
- Deixeu un comentari amb l'aprovació de la petició de fusió.
- 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:
- Cerqueu una petició de fusió nova, i afegiu un comentari que sou voluntari per a provar-la.
- Construïu la petició de fusió a la vostra plataforma.
- Proveu la funcionalitat/correcció d'error i intenteu trencar-la!
- Proporcioneu comentaris sobre els resultats de la prova a la petició de fusió.
- Espereu actualitzacions a la petició de fusió (si calen).
- Continueu provant i proporcionant comentaris fins que confieu que el codi funciona.
- Deixeu un comentari amb l'aprovació de la petició de fusió.
- 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!