Doprinos

Vodič za doprinos WvdS FPC RAD Suite projektu.

Hvala vam na interesu za doprinos WvdS FPC RAD Suite projektu! Ovaj dokument objašnjava kako možete podnijeti doprinose.

• Free Pascal Compiler 3.2.2 ili noviji
• pas2js 2.2.0 ili noviji
• VS Code 1.85.0 ili noviji
• Node.js 18+ (za vsce)
• Git

• Pascal/Object Pascal
• Osnove VSCode ekstenzija
• Engleski za komentare u kodu

1. Provjerite je li greška već prijavljena
2. Stvorite Issue s:
   • Opisom problema
   • Koracima za reprodukciju
   • Očekivano vs. stvarno ponašanje
   • Verzija VS Code, OS, verzija ekstenzije
   • Relevantni izlazi zapisa (WVDS: Show Log)

1. Opišite željenu značajku
2. Objasnite slučaj korištenja
3. Skicirajte moguće implementacije

1. Forkajte repozitorij
2. Stvorite feature-branch
3. Implementirajte promjenu
4. Testirajte lokalno
5. Stvorite Pull Request

• Nema TODO/ - Potpune implementacije
• Komentari na engleskom - PasDoc format za javne API-je
• Konvencije imenovanja - TWvdS* za klase, IWvdS* za sučelja
• i18n - Bez hardkodiranih stringova, koristite Resourcestrings

• TypeScript/ručno pisani JavaScript
• Prazni exception handleri
• Magic Numbers
• SQL string konkatenacija
• Hardkodirani podaci za prijavu

• Nazivi unitova: WvdS.<Kategorija>.<Komponenta>.pas
• Funkcije: 12-24 retka, maks. 40
• Parametri: maks. 5-7
• DRY: Bez duplikacije koda

# Forkajte i klonirajte repozitorij
git clone https://github.com/VASE-KORISNICKO-IME/WvdS.FPC.git
cd WvdS.FPC
 
# Stvorite feature-branch
git checkout -b feature/moja-znacajka

• Pišite kod prema standardima
• Testirajte (kompilacija, testiranje ekstenzije)
• Commitovi s jasnim porukama

• Opišite promjenu
• Povežite relevantne Issues
• Dodajte snimke zaslona (kod UI promjena)

• Revieweri će dati povratne informacije
• Prilagodite promjene prema potrebi
• Nakon odobrenja slijedi merge

[ ] Kod se kompilira bez grešaka
[ ] Ekstenzija funkcionira u testu
[ ] Nema TODO/FIXME komentara
[ ] Javni API-ji su dokumentirani
[ ] Nema hardkodiranih stringova
[ ] Nema Magic Numbers
[ ] Testovi prolaze (ako postoje)
[ ] CHANGELOG.md ažuriran (kod novih značajki)

• Issues: Prijave grešaka, zahtjevi za značajke
• Pull Requests: Diskusije o kodu
• Discussions: Opća pitanja

Podnošenjem doprinosa pristajete da se vaši doprinosi objave pod istom licencom kao projekt.

Potpune razvojne smjernice nalaze se u Razvojnoj dokumentaciji:

• Osiguranje kvalitete
• Konvencije koda
• Razvoj ekstenzija

• GitHub: WvdS.FPC Repository
• Issues: Prijave grešaka

• Standardi kvalitete
• FAQ