Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
75 lines (52 loc) · 1.84 KB

CONTRIBUTING.md

File metadata and controls

75 lines (52 loc) · 1.84 KB
Raw

Contributing to File Organizer AI

Grazie per il tuo interesse nel contribuire a File Organizer AI! 🎉

Come contribuire

Segnalare Bug

  1. Verifica che il bug non sia già stato segnalato nelle Issues
  2. Apri una nuova Issue usando il template "Bug Report"
  3. Includi:
    • Descrizione chiara del problema
    • Passi per riprodurlo
    • Comportamento atteso vs comportamento effettivo
    • Screenshot se applicabile
    • Versione di Windows, .NET e Ollama

Proporre Nuove Funzionalità

  1. Apri una Issue con il template "Feature Request"
  2. Descrivi la funzionalità e il caso d'uso
  3. Attendi feedback prima di iniziare l'implementazione

Pull Request

  1. Fai fork del repository
  2. Crea un branch per la tua feature: git checkout -b feature/nome-feature
  3. Committa le modifiche: git commit -m 'Aggiungi nuova feature'
  4. Pusha il branch: git push origin feature/nome-feature
  5. Apri una Pull Request

Linee Guida per il Codice

  • Usa C# 12 e .NET 8 features
  • Segui le convenzioni di naming Microsoft
  • Documenta le classi e i metodi pubblici con XML comments
  • Scrivi codice in inglese, commenti e UI in italiano
  • Mantieni i metodi brevi e con singola responsabilità

Setup Ambiente di Sviluppo

# Clona il repo
git clone https://github.com/USERNAME/FileOrganizerAI.git
cd FileOrganizerAI

# Ripristina pacchetti
dotnet restore

# Compila
dotnet build

# Esegui
dotnet run --project src/FileOrganizerAI.WPF

Testing

Prima di aprire una PR, assicurati che:

  1. Il codice compili senza errori
  2. L'applicazione si avvii correttamente
  3. Le funzionalità esistenti continuino a funzionare

Codice di Condotta

  • Sii rispettoso e costruttivo
  • Accetta feedback con apertura
  • Aiuta gli altri contributors

Domande?

Apri una Issue con il tag "question" o contattaci direttamente.

Grazie per contribuire! 🚀