Förbättra beskrivningar av pull-begäranden med hjälp av mallar

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Att skriva bra beskrivningar av pull-begäranden är ett bra sätt att hjälpa granskare att veta vad de kan förvänta sig när de granskar kod. De är också ett bra sätt att spåra saker som bör göras för varje ändring, till exempel testning, tillägg av enhetstester och uppdatering av dokumentation. Mallar för pull-begäranden kan hjälpa dina utvecklare att skapa bra beskrivningar av pull-begäranden som uppfyller organisationens standarder.

Den här artikeln visar hur du kommer igång med pull-begärandemallar.

Anmärkning

Mallar för pull-begäranden kan ge vägledning, men är endast rådgivande. Använd grenprinciper för att tillämpa metodtips som att kräva pull-begäranden för nyckelgrenar som main, kräva en lyckad version och framtvinga nödvändiga granskare. Mer information finns i grenprinciper.

Förutsättningar

Kategori	Krav
Åtkomst till projekt	Medlem av ett -projekt.
behörigheter	Visa kod i privata projekt: Minst grundläggande åtkomst . – Klona eller bidra till kod i privata projekt: Medlem i Bidragsgivare säkerhetsgrupp eller projektets motsvarande behörigheter. – Ange behörigheter för gren eller lagringsplats: Hantera behörigheter behörigheter för grenen eller lagringsplatsen. – Ändra standardgren: Redigera principer behörigheter för lagringsplatsen. – Importera en lagringsplats: Medlem i Projektadministratörer säkerhetsgrupp eller Git-projektnivå Skapa lagringsplats behörighet inställd på Tillåt. Mer information finns i Ange Behörigheter för Git-lagringsplats.
Tjänster	Repos aktiverat.
Verktyg	Valfritt. Använd kommandona az repos: Azure DevOps CLI.

Anmärkning

I offentliga projekt har användare med åtkomst på intressentnivå fullständig åtkomst till Azure Repos, inklusive att se, klona och bidra till kod.

Vad är en mall för pull-begäranden?

En pull-begärandemall är en fil som innehåller Markdown-text som läggs till i beskrivningen av pull-begäran när pull-begäran skapas.

Thank you for your contribution to the Fabrikam Fiber repo. 
Before submitting this PR, please make sure:

- [ ] Your code builds clean without any errors or warnings
- [ ] You are using approved terminology
- [ ] You have added unit tests

Med Azure Repos kan du skapa följande typ av pull-begärandemallar:

• En standardmall för pull-begäranden som tillämpas automatiskt för alla nya pull-begäranden på lagringsplatsen, såvida den inte åsidosätts av en grenspecifik pull-begärandemall
• Grenspecifika pull-begärandemallar som tillämpas automatiskt på pull-begäranden som riktar sig till en specifik gren
• Ytterligare mallar för pull-begäranden som skaparen valfritt kan lägga till

Typen av pull-begärandemall bestäms av dess filnamn och mappplats enligt beskrivningen i följande avsnitt. Filnamnen och mappplatserna är inte skiftlägeskänsliga, men de måste finnas i standardgrenen för lagringsplatsen.

Anmärkning

Alla mallfiler för pull-begäranden måste finnas i standardgrenen (vanligtvis huvud) för lagringsplatsen. Endast pull-requestmallfiler från huvudgrenen används.

Standardmallar för pull-begäranden

Standardmallar för pull-begäranden tillämpas automatiskt på beskrivningsfältet när en ny pull-begäran skapas. Om du vill konfigurera lagringsplatsen med en standardmall för pull-begäranden skapar du en fil med namnet pull_request_template.md eller pull_request_template.txt och sparar den i standardgrenen för lagringsplatsen i någon av följande mappar.

• En mapp med namnet .azuredevops som finns i rotmappen på lagringsplatsen
• En mapp med namnet .vsts som finns i rotmappen på lagringsplatsen
• En mapp med namnet docs som finns i rotmappen på lagringsplatsen
• Rotmappen för lagringsplatsen

Flera platser tillhandahålls för att ge dig flexibilitet i var du lagrar mallar för pull-begäranden. När en pull-begäran skapas söker Azure Repos igenom de angivna mapparna i den angivna ordningen och använder den första standardmallen för pull-begäranden som den hittar.

När en ny pull-begäran skapas på lagringsplatsen, såvida inte en grenspecifik pull-begärandemall gäller, används innehållet i standardmallen för pull-begäran för att fylla i beskrivningsfältet i pull-begäran.

Du kan redigera eller lägga till i den här beskrivningen och lägga till ytterligare pull-begärandemallar om du vill genom att välja dem i listrutan Lägg till en mall .

Anmärkning

När en standard- eller grenspecifik pull-begärandemall tillämpas automatiskt ersätter den de standardincheckningsmeddelanden som vanligtvis används för standardbeskrivningen. Du kan lägga till dem igen genom att välja Lägg till incheckningsmeddelanden.

Grenspecifika pull-begärandemallar

Grenspecifika pull-begärandemallar kan konfigureras för pull-begäranden som riktar sig till en specifik gren. Om du vill konfigurera lagringsplatsen med en grenspecifik pull-begärandemall skapar du en .txt- eller .md-fil med namnet efter din gren. Namnet måste matcha den första nivån i grennamnet, till exempel main, dev, releaseeller feature. Varje grenspecifik pull-begärandemall tillämpas varje gång en pull-begäran riktar sig mot den grenen eller alla grenar som ingår i den. Till exempel tillämpas mallen för pull-begäranden med namnet feature.md om en pull-begäran riktar sig mot grenen feature eller några feature/* grenar.

Förgreningsspecifika pull-begärandemallar måste sparas i standardgrenen för lagringsplatsen med hjälp av följande mapphierarki: pull_request_template/branches/. Dessa mappar måste vara baserade i någon av följande mappar på lagringsplatsen.

• En mapp med namnet .azuredevops som finns i rotmappen på lagringsplatsen
• En mapp med namnet .vsts som finns i rotmappen på lagringsplatsen
• En mapp med namnet docs som finns i rotmappen på lagringsplatsen
• Rotmappen för lagringsplatsen

Till exempel skulle en grenspecifik pull-begärandemall som ska gälla för alla pull-begäranden till grenen dev namnges dev.md eller dev.txt finnas på någon av följande platser.

• <repository root>/.azuredevops/pull_request_template/branches/
• <repository root>/.vsts/pull_request_template/branches/
• <repository root>/docs/pull_request_template/branches/
• <repository root>/pull_request_template/branches/

Precis som standardmallar för pull-begäranden tillhandahålls flera platser för att ge dig flexibilitet i var du lagrar grenspecifika pull-begärandemallar. När en pull-begäran skapas söker Azure Repos igenom de avsedda mapparna i den ordning som anges för en grenspecifik pull-begärandemall och använder den första som den hittar som matchar grennamnet. Om ingen grenspecifik pull-begärandemall hittas söker Azure Repos efter en standardmall för pull-begäran enligt beskrivningen i föregående avsnitt med standardmallar för pull-begäranden .

Ytterligare mallar för pull-begäranden

Förutom standardmallarna och grenspecifika pull-begärandemallar kan du konfigurera ytterligare pull-begärandemallar. Dessa kan vara .md eller .txt filer, som finns i någon av följande mappar i din standardgren.

• <repository root>/.azuredevops/pull_request_template/
• <repository root>/.vsts/pull_request_template/
• <repository root>/docs/pull_request_template/
• <repository root>/pull_request_template/

När en pull-begäran skapas kan du lägga till någon av de tillgängliga pull-begärandemallarna genom att välja dem i listrutan Lägg till en mall . Namnen i listrutan baseras på filnamnen för mallarna.

I följande exempel visas tre mallar.

• dev.md – Det här är den grenspecifika mall som tillämpades som standard på den här pull-begäran i dev-grenen, vilket anges av standardmeddelandet som anges efter filnamnet.
• additional.md – Det här är ytterligare en mall.
• pull_request_template.md – Det här är normalt standardmallen, men den åsidosättades av den dev.md grenspecifika mallen i den här pull-begäran. Även om den inte har lagts till som standard kan den fortfarande tillämpas genom att välja den i listan.

Välj namnet på den önskade ytterligare mallen för att lägga till innehållet i den aktuella beskrivningen av pull-begäran.

Anmärkning

Du kan ange en pull-begärandemall för att åsidosätta matchande standard- eller grenspecifika pull-begäranden genom att lägga ?template=name.md till i frågesträngen.

Se även

• Skapa en pull-begäran för att granska och slå samman kod
• Om grenar och grenprinciper