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:
- 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. - 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.
- 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ó! - Espereu una revisió breu de codi i almenys dos altres voluntaris per a provar la vostra característica 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'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!
- Busqueu 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 siga raonable.
- Deixeu un comentari amb l'aprovació de la petició de fusió.
- 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:
- Busqueu 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 característica/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 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!