====== Contribuire ======

Guida ai contributi per la WvdS FPC RAD Suite.

===== Benvenuti =====

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

===== Prerequisiti =====

==== Ambiente di sviluppo ====

  * **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**

==== Conoscenze ====

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

===== Tipi di contributi =====

==== Bug Report ====

  - Verificate se il bug è già stato segnalato
  - 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'')

==== Richieste di funzionalità ====

  - Descrivete la funzionalità desiderata
  - Spiegate il caso d'uso
  - Delineate possibili implementazioni

==== Contributi di codice ====

  - Fate un fork del repository
  - Create un branch per la funzionalità
  - Implementate la modifica
  - Testate localmente
  - Create una pull request

===== Standard del codice (sintesi) =====

==== Obbligatori ====

  * **Nessun TODO/FIXME** - 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

==== Vietati ====

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

==== Raccomandati ====

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

===== Processo pull request =====

==== 1. Preparazione ====

<code bash>
# 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
</code>

==== 2. Implementazione ====

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

==== 3. Pull Request ====

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

==== 4. Review ====

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

===== Checklist prima della pull request =====

<code>
[ ] 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à)
</code>

===== Comunicazione =====

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

===== Licenza =====

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

===== Per dettagli tecnici =====

Le linee guida complete per sviluppatori si trovano nella [[..:i:start|Documentazione per sviluppatori]]:

  * [[..:i:qualitaetssicherung|Garanzia di qualità]]
  * [[..:i:code-konventionen|Convenzioni del codice]]
  * [[..:i:extension-entwicklung|Sviluppo estensioni]]

===== Contatti =====

  * **GitHub:** [[https://github.com/ArmandoFilho/WvdS.FPC|Repository WvdS.FPC]]
  * **Issues:** [[https://github.com/ArmandoFilho/WvdS.FPC/issues|Bug Report]]

===== Vedere anche =====

  * [[.:qualitaetssicherung|Standard di qualità]]
  * [[.:faq|FAQ]]