Vai al contenuto principale

​
Template per Pull Request

Devin può usare template di pull request in stile GitHub. Cerca nel tuo repository il primo file di template corrispondente e lo usa quando genera o rigenera una descrizione di PR. Oltre ai nomi di file standard di GitHub, Devin supporta anche una variante specifica per Devin, così puoi fornire a Devin un template diverso da quello usato dai tuoi autori umani.

​
1. Ordine di individuazione

Vince il primo elemento che corrisponde (dall’alto verso il basso): 
PULL_REQUEST_TEMPLATE/DEVIN_PR_TEMPLATE.md
docs/PULL_REQUEST_TEMPLATE/DEVIN_PR_TEMPLATE.md
.github/PULL_REQUEST_TEMPLATE/DEVIN_PR_TEMPLATE.md
PULL_REQUEST_TEMPLATE/devin_pr_template.md
docs/PULL_REQUEST_TEMPLATE/devin_pr_template.md
.github/PULL_REQUEST_TEMPLATE/devin_pr_template.md
PULL_REQUEST_TEMPLATE.md
pull_request_template.md
docs/PULL_REQUEST_TEMPLATE.md
docs/pull_request_template.md
.github/PULL_REQUEST_TEMPLATE.md
.github/pull_request_template.md
Le voci DEVIN_PR_TEMPLATE.md e devin_pr_template.md sono sostituzioni opzionali specifiche di Devin (sono supportate sia le varianti in maiuscolo che in minuscolo). Se nessuna di queste è presente, vengono utilizzate le posizioni standard PULL_REQUEST_TEMPLATE.md e pull_request_template.md. Se non viene trovato nulla, Devin usa la sua struttura predefinita incorporata.

​
2. Modello Devin personalizzato (opzionale)

Aggiungi un modello dedicato a Devin creando uno dei seguenti: 
.github/PULL_REQUEST_TEMPLATE/DEVIN_PR_TEMPLATE.md
.github/PULL_REQUEST_TEMPLATE/devin_pr_template.md
docs/PULL_REQUEST_TEMPLATE/DEVIN_PR_TEMPLATE.md
docs/PULL_REQUEST_TEMPLATE/devin_pr_template.md
PULL_REQUEST_TEMPLATE/DEVIN_PR_TEMPLATE.md
PULL_REQUEST_TEMPLATE/devin_pr_template.md
Usa questa opzione se vuoi che Devin includa una struttura aggiuntiva (ad esempio suggerimenti per le checklist di rischio) senza cambiare ciò che le persone vedono nel loro consueto PULL_REQUEST_TEMPLATE.md o pull_request_template.md. Sono supportate sia le varianti maiuscole che minuscole. Se preferisci un singolo modello condiviso, mantieni (o aggiungi): 
.github/pull_request_template.md
I segnaposto e i commenti HTML verranno eliminati automaticamente.

​
3. Impostazione predefinita incorporata (se non viene trovato alcun file)

Se non esiste alcun file di template, Devin utilizza un’impostazione predefinita interna con sezioni per:
  • Summary
  • Review & Testing Checklist
  • (Optional) Mermaid diagram
  • Notes
Non è necessario copiarla a meno che tu non voglia personalizzarla; fornire uno qualsiasi dei file supportati sopra sostituisce completamente l’impostazione predefinita.

​
4. Riferimento GitHub

Devin segue le regole di GitHub per la risoluzione dei template a file singolo. Per maggiori informazioni sui template di PR di GitHub (incluse configurazioni con più template), consulta la documentazione qui.
Configurazione minima per assegnare a Devin un template dedicato: 
mkdir -p .github/PULL_REQUEST_TEMPLATE
echo "# [titolo]\n\n## Riepilogo\n...\n" > .github/PULL_REQUEST_TEMPLATE/devin_pr_template.md
È tutto: apri o rigenera una PR e Devin la utilizzerà.