LogoLogo
PAO DocsInfrastructure DocsDeveloper DocsPeerplays.com
  • Introduction to Peerplays
  • Concepts
    • Decentralization
    • Consensus Mechanisms Compared
  • Technology
    • Peerplays Technical Summary
    • Intro to Peerplays Tokens
    • Intro to Peerplays Liquidity Pools
      • Service Infrastructure Pools
    • Staking (PowerUp) in Peerplays
    • Gamified User Namespaces and Subject Matter Expert Committees
    • Peer-to-Peer Autonomous Organizations: Flow Diagram
    • Gamified Proof of Stake (GPOS)
      • Wallet User Guide
        • GPOS Panel
        • GPOS Landing Page
        • Power Up
        • Power Down
        • Vote
        • Thank you for voting!
      • FAQ
        • General
        • GPOS Panel
        • Power Up & Power Down
        • Voting
        • Participation Rewards
    • Sidechain Operator Nodes (SONs)
      • New to SONs?
        • What are Sidechain Operating Nodes?
        • How do SONs Work?
        • Why are SONs important?
        • How do SONs impact me?
        • SON Fees & Performance Requirements
        • Peerplays SONs
      • FAQ
      • Running a SON Node
    • NFTs and Marketplace
      • NFT marketplace in Python
      • NFT Operations in Python
      • NFT, Marketplace, HRP, and RBAC related Commands/Use Cases
      • NFT command reference
    • Peerplays DEX
      • User Guide
        • Account Creation
        • Dashboard
          • Bitcoin Transaction
        • Market Activity
        • Peerplays Blocks
        • Settings
        • Wallet
        • Profile
        • GPOS - Voting
        • Logout
  • Witnesses
    • What is a Peerplays Witness?
    • Becoming a Peerplays Witness
    • Hardware Requirements
    • Installation Guides
  • Bookie Oracle Suite (BOS)
    • Introduction to BOS
    • BOS Installation
    • BookieSports
    • Manual Intervention Tool (MINT)
  • Data Proxies
    • Introduction to Data Proxies
    • How Data Proxies Work
    • Data Proxy Set Up
  • Couch Potato
    • Introduction
    • Installation
    • User Guide
  • Random Number Generator (RNG)
    • RNG Technical Summary
    • RNG API
  • API
    • Peerplays Core API
      • Popular API Calls
      • Account History API
      • Asset API
      • Block API
      • Crypto API
      • Database API
      • Network Broadcast API
      • Network Nodes API
      • Orders API
    • Wallet API
      • Account Calls
      • Asset Calls
      • Blockchain Inspection
      • General Calls
      • Governance
      • Privacy Mode
      • Trading Calls
      • Transaction Builder
      • Wallet Calls
    • Bookie API
      • General
      • Tournaments
      • Listeners
    • Python Peerplays
      • Installation
      • Creating the wallet
      • Creating an Account
      • NFT
      • Market Place
      • HRP / RBAC
  • Connecting Elasticsearch to a blockchain node
  • GitLab
    • GitLab Ticket Templates
    • Labels
    • Time Tracking
  • Other Documentation
    • Peerplays Home
    • Infrastructure Docs
    • Developer Docs
    • Site Reliability Engineering
  • Known Issues
    • Peerplays Disaster Recovery Plan
    • Sept 2021 Mainnet Outage - Postmortem Report
  • Kickstart Guide
    • Peerplays Developer
  • Risk Register
    • Introduction
      • Bunker Issue
        • DDOS Attack
        • Hypervisor Compromised
        • Power and Backup Failure
        • Crypto Restriction
      • Core-Block Issue
        • Expensive Servers
        • Witness node - Not reachable
        • Witnesses get DDOS'd
        • Bad Actor infiltrate witness/SONs
      • Credential Security
        • NEX Open Source Vulnerabilities
        • Keyloggers, access to NEX deployment
        • Password manager hacked
        • SONs active keys exposed in configuration
    • Glossary
  • Operation Cost Estimation
    • Project Operations
    • Cost Estimation
Powered by GitBook
On this page
  • 1. Overview
  • 2. Bug Tickets
  • 3. User Story / Implementation of a New Feature
  • Appendix A - Determining Ticket Priority
  • Appendix B - Copy / Paste Description Templates
  • Bugs
  • User Stories
Export as PDF
  1. GitLab

GitLab Ticket Templates

Templates for the different types of tickets in GitLab.

PreviousConnecting Elasticsearch to a blockchain nodeNextLabels

Last updated 3 years ago

1. Overview

The following templates help document tickets (issues) in GitLab. They are a starting point and reference for anyone unfamiliar with the ticketing process. There are two main templates given here; one for reporting bugs, and one for the implementation of a User Story (new feature).

Required fields listed below may not be required (strictly speaking) in GitLab when submitting a new ticket. The information in these fields are required for our team to handle bug fixes and new features with speed and efficiency. A few extra minutes of your time now can save the team hours or days in the long run.

2. Bug Tickets

A bug is a defect in something that already exists. When found, bugs need to be documented in tickets to be tracked like any other work item. Bugs are unique in that they can be difficult to reproduce, have obscure root causes, and may not present themselves in all contexts. This is why providing detailed tickets is key to solving these issues.

Key Elements of a Bug ticket:

  1. Title (Required): Short title that clearly states the Bug.

  2. Type (Required): Issue (for general work) or Incident (For investigating IT service disruptions or outages).

  3. Description (Required): Detailed enough so that QA does not need to ask questions in order to test the ticket. This should include the following sections:

    1. Description: Describe the bug.

    2. Preconditions: If necessary in order to run the Scenario steps properly.

    3. Affected Version(s): If known, list the build(s) where the issue has been observed.

    4. Scenario: The steps to reproduce the issue. Should be clear, direct, and have enough details to be reproducible.

    5. Current Bugged Behavior: The observed issue as it actually happens.

    6. Expected Correct Behavior: The requirements that describe a successful outcome. Simply, what should happen.

    7. Attempted Fixes: What has already been done to try to solve the issue, and the results of the attempts.

    8. Possible Fixes: If possible, link to the line of code that might be responsible for the problem. Or list other insights into the problem.

    9. Attachments: This is the visual proof (screenshots, logs, video, etc.) of the existing issue. Any other useful information should be attached as well.

    10. Quick Actions: If necessary, use quick actions to relate issues to this ticket. (/relate #issue1 #issue2) See for more info.

  4. Assignees: If known, adding the appropriate individual(s) here will save time.

  5. Weight: Estimate of the effort needed to solve the issue. See for more info.

  6. Epic: If known, select the best related epic.

  7. Due Date: Can be left blank. It's useful if the issue is blocking something with a deadline.

  8. Milestone: If known, select the best related milestone.

  9. Labels (Required): The following three label types must be provided, but others can be added if necessary. See for more info.

    1. Priority: (low, medium, high, or critical) see the chart in for help deciding the priority level.

    2. Type: bug (in the case of this template!)

    3. State: pending (for new tickets)

3. User Story / Implementation of a New Feature

A user story is a simple way to describe features that need to be implemented (and does not yet exist). The template below is built to help fully describe the task(s) that needs to be completed to satisfy the requirements of a user story. In this case, a user story may be an improvement, a previously missed requirement or functional spec, or even a brand new feature.

Key Elements of a User Story:

  1. Title (Required): Short title that clearly states the User Story.

  2. Type (Required): Issue (for general work) or Incident (For investigating IT service disruptions or outages).

  3. Description (Required): A clear explanation of the required story's content so that QA does not need to ask questions in order to test and close the story ticket. Additional notes are welcome. This should include the following sections:

    1. Description: Describe the user story.

    2. Affected Version(s): If necessary, list the build(s) where the issue applies.

    3. Acceptance Criteria: The clear definition of the final solution. What does the goal look like?

    4. Attachments: If helpful, provide screenshots, logs, video, diagrams, documents, etc. pertaining to the issue. Any other useful information should be attached as well.

  4. Assignees: If known, adding the appropriate individual(s) here will save time.

  5. Epic: If known, select the best related epic.

  6. Due Date: Can be left blank. It's useful if the issue is blocking something with a deadline.

  7. Milestone: If known, select the best related milestone.

    1. Type: feature (in the case of this template!)

    2. State: pending (for new tickets)

Appendix A - Determining Ticket Priority

The priority of a ticket depends on a mix of aspects. Applying a priority is subjective. But we can help classify the priority by thinking in terms of impact and urgency:

Appendix B - Copy / Paste Description Templates

Bugs

Here is a template that you can quickly copy and paste into the Description field in the new GitLab bug ticket. This one has information to help guide you when entering information into the ticket.

## Description

(Required) Describe the bug here.

## Preconditions

(If necessary) In order to run the Scenario steps properly, list any preconditions.

- Precondition A
- Precondition B

## Affected Version(s)

(If known) List the build(s) where the issue has been observed.

- Build A
- Build B

## Scenario

(Required) The steps to reproduce the issue. Should be clear, direct, and have enough details to be reproducible.

1. Step 1...
2. Step 2...
3. Step 3...

## Current Bugged Behavior

(Required) The observed issue as it actually happens.

## Expected Correct Behavior

(Required) The requirements that describe a successful outcome. Simply, what should happen.

## Attempted Fixes

(Required, even if nothing) What has already been done to try to solve the issue, and the results of the attempts.

## Possible Fixes

(If possible) Link to the line of code that might be responsible for the problem. Or list other insights into the problem.

**Note**: Don't forget to attach any relevant files, and to use quick actions to link related issues or add time estimates. Then delete this note!

Or just the section headers if you prefer...

## Description



## Preconditions



## Affected Version(s)



## Scenario



## Current Bugged Behavior



## Expected Correct Behavior



## Attempted Fixes



## Possible Fixes


User Stories

Here is a template that you can quickly copy and paste into the Description field in the new GitLab user story ticket. This one has information to help guide you when entering information into the ticket.

## Description

(Required) Describe the user story.

## Affected Version(s)

(If necessary) List the build(s) where the issue applies.

- Build A
- Build B

## Acceptance Criteria

(Required) The clear definition of the final solution. What does the goal look like?

**Note**: Don't forget to attach any relevant files, and to use quick actions to link related issues or add time estimates. Then delete this note!

Or just the section headers if you prefer...

## Description



## Affected Version(s)



## Acceptance Criteria


Quick Actions: If necessary, use quick actions to relate issues to this ticket or provide a time estimate. (/relate #issue1 #issue2) See for more info.

Weight: Estimate of the effort needed to solve the issue. See for more info.

Labels (Required): The following three label types must be provided, but others can be added if necessary. See for more info.

Priority: (low, medium, high, or critical) see the chart in for help deciding the priority level.

Quick Actions
Time Tracking > Weight
Labels > Scoped Labels
Quick Actions
Time Tracking > Weight
Labels > Scoped Labels
Appendix A
Appendix A
3KB
ticket-priority-matrix.xml
Ticket Priority Matrix (Draw.io XML)