Spring naar inhoud

Bijdragen


Geïnteresseerd in het maken van ghostwriter nog beter? Lees de onderstaande secties om te zien hoe u kunt bijdragen.

Bugrapporten

Een bug gevonden? Rapporteer deze op de KDE probleemvolger. Vergeet niet de richtlijnen voor rapporteren van problemen te volgen! Meest belangrijk, vergeet niet het versienummer van ghostwriter dat u gebruikt mee te geven.

Waarschuwing: Het niet leveren van de vereiste informatie in het bugrapportsjabloon heeft als gevolg dat het bugrapport automatisch wordt gesloten.

Bugs onderzoeken

U kunt helpen met problemen te onderzoeken in de probleemvolger door bugs te reproduceren en meer informatie uit bugrapporten te krijgen om te helpen bij het nader brengen van waar het probleem zit. Gedupliceerde problemen sluiten en ander opruimen zou ook op prijs worden gesteld. Voor meer informatie, bekijk de richtlijnen voor bugs onderzoeken.

Nieuwe mogelijkheden en reparaties van bugs

Weet u hoe te coderen? Volg deze stappen:

  1. Dien een issue in voor uw functie of bug op de KDE probleemvolger.
    Opmerking: Deze stap is nodig om te verzekeren dat de nieuwe functie overeenkomt met de doelen van het project of dat de bug niet echt een functie is. U zou ook de gebieden van uw code willen coördineren die u wilt bijwerken om conflicten met andere wijzigingen te vermijden in geval iemand anders in datzelfde gebied van de code bezig is als u.
  2. Na discussie over uw nieuwe issue, codeer uw mogelijkheid of reparatie van de bug. Volg daarbij de KDE Frameworks coderingsstijlgids. Belangrijk: Houd uw code gefocust op het op te lossen probleem. Niet gerelateerde wijzigingen in de code behoren tot een apart probleem/samenvoeg verzoek om herzien van code en testen gemakkelijker te maken.
  3. Dien een pull-verzoek in tegen de master-branch met uw bijgewerkte code.
    Belangrijk: Stop uw commits in git alvorens het pull-verzoek in te dienen!
  4. Wacht op een korte evaluatie van de code en minstens twee andere vrijwilligers om test uw functie of reparatie van de bug te testen.
  5. Werk uw pull-verzoek bij als u terugkoppeling krijgt.
  6. Wanneer het pull-verzoek is goedgekeurd door minstens twee andere vrijwillige testers, zal uw pull-verzoek worden samengevoegd (merge).

Reviews van code

Weet u hoe te coderen en oog voor detail hebben? Wees vrijwilliger om nieuwe verzoeken voor merge te evalueren!

  1. Zoek naar een nieuw verzoek voor merge en voeg een opmerking toe dat u vrijwillig mee doet aan het evalueren van de code.
  2. Dien uw evaluatie van de code in.
  3. Wacht op updates voor het merge-verzoek (indien nodig).
  4. Ga door met het leveren van terugkoppeling totdat u er zeker van bent dat de code is gezond is.
  5. Laat een commentaar achter met uw toestemming voor het merge-verzoek.
  6. Nadat minstens twee vrijwillige testers hun toestemming hebben ingediend, zal het merge-verzoek worden uitgevoerd.

Hier zijn enige tips over waar naar te kijken in code reviews:

  • Volgt de ingediende code de KDE Frameworks coderingsstijlgids?
  • Is de code leesbaar, met commentaar die elke niet-voor-de-hand liggende regel?
  • Is de code "pessimistisch"? Met andere woorden, controleert het op ongeldige waarden voor ze te gebruiken en worden mogelijke foutcondities behandeld?
  • Zijn meerder vergelijkingen of statements omgeven door haakjes in if-statements om ongelukken te voorkomen met volgorde van bewerkingen? Voorbeelden:
    // Verkeerd
    if (a == b || c > d);
    
    // Corrigeren
    if ((a == b) || (c > d));
    
  • Staan literals aan de linkerkant van de == operator om een typo te voorkomen met de = operator zodat de meldingen van de compiler niet komen? Voorbeelden:
    // Verkeerd
    if (variable == 1);
    
    //         Reden: Wat als er een typo is? De compiler zal het niet ontdekken!
    if (variable = 1); // Oops!
    // Corrigeren
    if (1 == variable);
    
    //         Reden: Deze keer zal de compiler de typo ontdekken.
    if (1 = variable); // Oops!
    

Testen

Wees een vrijwilliger om code review te doen en nieuwe functies en reparaties van bugs te testen! Volg deze stappen:

  1. Zoek naar een nieuw merge-verzoek en voeg een commentaar toe dat u vrijwilliger bent om het te testen.
  2. Bouw het merge-verzoek op uw platform.
  3. Test de functie/reparatie van de bug en probeer het te breken!
  4. Lever terugkoppeling op testresultaten in het merge-verzoek.
  5. Wacht op updates voor het merge-verzoek (indien nodig).
  6. Ga door met testen en lever terugkoppeling totdat u er zeker van bent dat de code werkt.
  7. Laat een commentaar achter met uw toestemming voor het merge-verzoek.
  8. Nadat minstens één andere vrijwillige tester toestemming heeft ingediend, zal het merge-verzoek worden geaccepteerd.

Vertalingen

Overweg mee te doen met het KDE vertaalteam of vertaal uw favoriete toepassingen in andere talen.

Technische ondersteuning

Kennis over Linux of bouwen voor MacOS? Weten hoe dat ene probleem gerepareerd kan worden waar anderen steeds last van hebben? Uw antwoord op gebruikersvragen en probleemoplossen in de KDE bugvolger zou zeer op prijs worden gesteld!