---
icon: lucide/heart-handshake
---

<!-- SPDX-FileCopyrightText: 2026 PythonWoods <dev@pythonwoods.dev> -->
<!-- SPDX-License-Identifier: Apache-2.0 -->

# Contribuire

Per rispondere efficacemente alle esigenze degli utenti, abbiamo progettato con cura le nostre
linee guida per i contributi e ottimizzato i nostri template per garantire un'esperienza
complessiva eccellente con il progetto.

Il nostro obiettivo è garantire che la documentazione e il nostro issue tracker siano
__ben strutturati__, __facili da navigare__ e __ricercabili__, così da trovare rapidamente
ciò di cui hai bisogno. Seguendo le nostre linee guida, possiamo aiutarti molto più velocemente.

In questa sezione ti guidiamo attraverso i nostri processi.

## Crea un'Issue

<div class="grid cards" markdown>

- :lucide-bug: &nbsp;
    __Qualcosa non funziona?__

    ---

    Segnala un bug in Zenzic creando un'issue con una riproduzione del problema.

    ---

    :lucide-arrow-right: [Segnala un bug][segnala un bug]

- :material-file-edit-outline: &nbsp;
    __Informazioni mancanti nei docs?__

    ---

    Segnala informazioni mancanti o potenziali incongruenze nella documentazione.

    ---

    :lucide-arrow-right: [Segnala un problema nei docs][problema nei docs]

- :material-lightbulb-on-outline: &nbsp;
    __Vuoi proporre un'idea?__

    ---

    Proponi una modifica, una richiesta di funzionalità o suggerisci un miglioramento.

    ---

    :lucide-arrow-right: [Richiedi una modifica][richiesta di modifica]

</div>

## Contribuisci

<div class="grid cards" markdown>

- :lucide-git-pull-request: &nbsp;
    __Vuoi contribuire al codice?__

    ---

    Contribuisci allo sviluppo di Zenzic aprendo una pull request.

    ---

    :lucide-arrow-right: [Apri una pull request][apri una pull request]

</div>

  [segnala un bug]: report-a-bug.md
  [problema nei docs]: report-a-docs-issue.md
  [richiesta di modifica]: request-a-change.md
  [apri una pull request]: pull-requests.md

## Checklist

Prima di interagire all'interno del progetto, prenditi un momento per considerare le
seguenti domande. In questo modo ti assicuri di utilizzare il template corretto e di
fornire tutte le informazioni necessarie.

!!! warning "Le issue e i commenti sono permanenti"

    Tutto ciò che scrivi è permanente e rimarrà visibile a tutti — per sempre.
    Ti chiediamo quindi di essere sempre costruttivo e rispettoso, attenendoti
    al nostro [Codice di Condotta].

### Prima di creare un'issue

- Stai usando il template di issue appropriato, o ne esiste un altro che si adatta
  meglio al contesto della tua richiesta?

- Hai verificato se un bug simile o una richiesta analoga è già stata creata, o hai
  trovato qualcosa che potrebbe essere correlato?

- Hai compilato ogni campo come richiesto e fornito tutte le informazioni aggiuntive
  di cui i maintainer hanno bisogno per comprendere la tua richiesta?

### Prima di commentare

- Il tuo commento è pertinente all'argomento dell'issue corrente, oppure è meglio
  creare una nuova issue perché è solo vagamente correlato?

- Il tuo commento aggiunge valore alla conversazione? È costruttivo e rispettoso
  verso la community e i maintainer? Potresti usare una [reaction] invece?

## Contributi incompleti

Abbiamo progettato con cura il nostro processo di contribuzione per garantire che le
issue possano essere esaminate e gestite in modo efficiente. Ogni campo nei nostri
template è strutturato per raccogliere i dettagli essenziali necessari a comprendere
appieno la tua segnalazione.

__Ci riserviamo il diritto di gestire le issue non conformi alle linee guida nel
seguente modo:__

### Issue incomplete

Ci _riserviamo il diritto di chiudere le issue prive di informazioni essenziali_,
come riproduzioni mancanti o non conformi agli standard di qualità. Riapriremo
un'issue una volta fornite le informazioni mancanti.

### Domande come issue

Ci _riserviamo il diritto di chiudere le domande aperte come issue_. L'issue tracker
non è un luogo per domande, ma per [segnalazioni di bug][segnala un bug],
[problemi di documentazione][problema nei docs] e [richieste di modifica][richiesta di modifica]
dettagliate.

### Issue duplicate

Per mantenere una comunicazione organizzata ed efficiente, ci _riserviamo il diritto
di chiudere qualsiasi issue duplicata_.

### Issue riaperte

Ci _riserviamo il diritto di chiudere immediatamente le issue riaperte senza nuove
informazioni_.

  [reaction]: https://github.blog/2016-03-10-add-reactions-to-pull-requests-issues-and-comments/
