Contribuire

Guida ai contributi per la WvdS FPC RAD Suite.

Grazie per il vostro interesse a contribuire alla WvdS FPC RAD Suite! Questo documento spiega come inviare contributi.

• Free Pascal Compiler 3.2.2 o superiore
• pas2js 2.2.0 o superiore
• VS Code 1.85.0 o superiore
• Node.js 18+ (per vsce)
• Git

• Pascal/Object Pascal
• Basi delle estensioni VSCode
• Inglese per i commenti nel codice

1. Verificate se il bug è già stato segnalato
2. Create una issue con:
   • Descrizione del problema
   • Passi per riprodurre
   • Comportamento atteso vs. effettivo
   • Versione VS Code, OS, versione estensione
   • Output di log rilevanti (WVDS: Show Log)

1. Descrivete la funzionalità desiderata
2. Spiegate il caso d'uso
3. Delineate possibili implementazioni

1. Fate un fork del repository
2. Create un branch per la funzionalità
3. Implementate la modifica
4. Testate localmente
5. Create una pull request

• Nessun TODO/ - Implementazioni complete
• Commenti in inglese - Formato PasDoc per API pubbliche
• Convenzioni di denominazione - TWvdS* per classi, IWvdS* per interfacce
• i18n - Nessuna stringa hardcoded, usare resourcestring

• TypeScript/JavaScript scritto a mano
• Handler di eccezione vuoti
• Numeri magici
• Concatenazione di stringhe SQL
• Credenziali hardcoded

• Nomi unit: WvdS.<Categoria>.<Componente>.pas
• Funzioni: 12-24 righe, max. 40
• Parametri: max. 5-7
• DRY: Nessuna duplicazione di codice

# Fork del repository e clone
git clone https://github.com/IL-VOSTRO-USERNAME/WvdS.FPC.git
cd WvdS.FPC
 
# Creare feature branch
git checkout -b feature/mia-funzionalita

• Scrivete codice secondo gli standard
• Testate (compilazione, test dell'estensione)
• Commit con messaggi significativi

• Descrivete la modifica
• Collegate le issue rilevanti
• Aggiungete screenshot (per modifiche UI)

• I reviewer forniranno feedback
• Adattate le modifiche di conseguenza
• Dopo l'approvazione verrà fatto il merge

[ ] Il codice compila senza errori
[ ] L'estensione funziona nei test
[ ] Nessun commento TODO/FIXME
[ ] API pubbliche documentate
[ ] Nessuna stringa hardcoded
[ ] Nessun numero magico
[ ] Test superati (se presenti)
[ ] CHANGELOG.md aggiornato (per nuove funzionalità)

• Issues: Bug report, richieste funzionalità
• Pull Requests: Discussioni sul codice
• Discussions: Domande generali

Inviando contributi, accettate che i vostri contributi vengano pubblicati sotto la stessa licenza del progetto.

Le linee guida complete per sviluppatori si trovano nella Documentazione per sviluppatori:

• Garanzia di qualità
• Convenzioni del codice
• Sviluppo estensioni

• GitHub: Repository WvdS.FPC
• Issues: Bug Report

• Standard di qualità
• FAQ