Vorlagen für Probleme und Pull-Anfragen erstellen

Auf dieser Seite wird beschrieben, wie Sie Vorlagen für Probleme und Pull-Anfragen für Secure Source Manager erstellen und konfigurieren.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Arbeiten mit Vorlagen für Probleme und Pull-Anfragen benötigen:

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Informationen zum Zuweisen von Secure Source Manager-Rollen, siehe Zugriffssteuerung mit IAM und Nutzern Instanzzugriff gewähren.

Vorlagen – Übersicht

Mit Vorlagen für Probleme und Pull-Anfragen können Sie die Informationen standardisieren, die Mitwirkende für ein Repository bereitstellen. Vorlagen für Probleme bieten vordefinierte Optionen, aus denen ein Nutzer je nach Art des Problems und den verfügbaren Vorlagentypen auswählen kann. Eine Vorlage für Pull-Anfragen wird automatisch auf alle Pull-Anfragen angewendet, um einheitliche Beiträge zum Repository zu gewährleisten.

Vorlagen können von allen Nutzern erstellt werden, die die Berechtigung zum Zusammenführen von Dateien in einem Repository haben.

Vorlage für Probleme erstellen

Mit Secure Source Manager können Sie Vorlagen für Probleme mithilfe von Markdown-Dateien an mehreren Speicherorten in Ihrem Repository definieren. Sie können mehrere Vorlagen für Probleme für verschiedene Zwecke erstellen. Beispielsweise können Sie separate Vorlagen für das Melden von Fehlern und das Einreichen von Funktionsanfragen verwenden.

  1. Erstellen Sie eine Vorlage, die mit den folgenden Informationen in diesem genauen Format beginnt:

     ---
 name: TEMPLATE_NAME
 about: Insert description of template
 title: Placeholder title for the new issue when it is created
 ---

  2. Geben Sie einen Namen und eine Beschreibung an. Diese sind erforderlich und werden in der Benutzeroberfläche der Seite „Neue Probleme“ verwendet.

  3. Optional können Sie einen Titel angeben, der als Platzhalter für den Titel verwendet wird, wenn ein neues Problem erstellt wird.

  4. Fügen Sie unter den erforderlichen Informationen alle Informationen ein, die in der Problembeschreibung angezeigt werden sollen und die Nutzern helfen, die erforderlichen Informationen bereitzustellen.

  5. Speichern Sie die Vorlage als Markdown-Datei an einem der folgenden Speicherorte:

    • /.securesourcemanager/ISSUE_TEMPLATES/
    • /.securesourcemanager/issue_templates/

Standardvorlage für Probleme

Secure Source Manager unterstützt auch die Definition einer einzelnen Standardvorlage. Diese Vorlage sollte an einem der folgenden Speicherorte definiert werden:

  • /.securesourcemanager/ISSUE_TEMPLATE.md
  • /.securesourcemanager/issue_template.md

Wenn ein Nutzer ein neues Problem erstellt, fordert Secure Source Manager ihn auf, eine Vorlage auszuwählen, falls verfügbar, oder wählt die Standardvorlage aus. Wenn keine Standardvorlage festgelegt ist, werden keine Informationen in das neue Problem eingefügt.

Beispielvorlage für Probleme

Die ersten fünf Zeilen der Vorlage müssen den Konventionen im folgenden Beispiel entsprechen. Alle zusätzlichen Informationen können in Markdown formatiert werden, um den Anforderungen des Problemtyps zu entsprechen.

---
name: Bug #Used as UI element for the button on the New Issues page
about: Use this template to submit a new bug #Used as description text on the New Issues page
title: [BUG]: <Describe issue> #Used as placeholder name for newly created issue
---
# Description

# Expected result

# Actual result

# Steps to reproduce
1.
2.

# Environment
-OS:
-Software version:
-Screenshots:

Vorlage für Pull-Anfragen erstellen

  1. Erstellen Sie eine Vorlage, die mit den folgenden Informationen in diesem genauen Format beginnt:

     ---
 title: "[PR]: <Insert title>"
 ---

  2. Fügen Sie unter den erforderlichen Informationen alle Informationen ein, die in der Problembeschreibung angezeigt werden sollen und die Nutzern helfen, die erforderlichen Informationen bereitzustellen. Weitere Informationen finden Sie in der Beispielvorlage im folgenden Abschnitt.

  3. Speichern Sie die Vorlage als Markdown-Datei an einem der folgenden Speicherorte in einem Repository:

    • /.securesourcemanager/PULL_REQUEST_TEMPLATE.md
    • /.securesourcemanager/pull_request_template.md

Wenn Sie eine neue Pull-Anfrage erstellen, prüft Secure Source Manager, ob an einem der definierten Speicherorte eine Vorlage vorhanden ist, und lädt sie. Wenn Sie in Ihrer Vorlage title -Informationen angegeben haben, werden diese automatisch in die neue Pull-Anfrage eingefügt, um Nutzern ein definiertes Format zu bieten. Alle zusätzlichen Informationen, die Sie angegeben haben, werden der Beschreibung der Pull-Anfrage hinzugefügt und können vom einreichenden Nutzer aktualisiert werden.

Beispielvorlage für Pull-Anfragen

Die ersten drei Zeilen der Vorlage müssen den Konventionen im folgenden Beispiel entsprechen. Alles, was folgt, sind Optionen, die Nutzern helfen sollen, Pull-Anfragen zu erstellen, die Ihren Konventionen entsprechen.

---
title: "[PR]: <Insert title>"
---
<!-- Thank you for your contribution! -->

<!-- Include if applicable: -->
Fixes: #nnn <!-- tracking issues that this PR will close -->
**Related**: _Relevant tracking issues, for context_
**Merge before/after**: _Dependent or prerequisite PRs_

**Description**
<!-- Describe your changes here. The more detail, the easier the review! -->

**User facing changes (remove if N/A)**
<!-- Describe any user facing changes this PR introduces. -->
<!-- "Before" and "After" sections work great - bonus points for screenshots! -->
<!-- Be sure all docs have been updated as well! -->

**Follow-up Work (remove if N/A)**
<!-- Mention any related follow up work to this PR. -->

Nächste Schritte