From 7d7b0f9c5a85925bf1781b4b33a8399fe59b1ec7 Mon Sep 17 00:00:00 2001
From: Maxim Belkin <maxim.belkin@gmail.com>
Date: Mon, 27 Jul 2020 14:12:34 +0000
Subject: [PATCH] feature and issue templates: shorter titles

---
 .github/ISSUE_TEMPLATE/bug.md     | 17 +++++++++++------
 .github/ISSUE_TEMPLATE/feature.md | 14 +++++++++-----
 2 files changed, 20 insertions(+), 11 deletions(-)

diff --git a/.github/ISSUE_TEMPLATE/bug.md b/.github/ISSUE_TEMPLATE/bug.md
index 67d0a3161c..e49b1295e1 100644
--- a/.github/ISSUE_TEMPLATE/bug.md
+++ b/.github/ISSUE_TEMPLATE/bug.md
@@ -4,7 +4,7 @@ about: "If you're sure it's reproducible and not just your machine: submit an is
 
 ---
 
-# Please note we will close your issue without comment if you delete, do not read or do not fill out the issue checklist below and provide ALL the requested information. If you repeatedly fail to use the issue template, we will block you from ever submitting issues to Homebrew again.
+**Please note we will close your issue without comment if you delete, do not read or do not fill out the issue checklist below and provide ALL the requested information. If you repeatedly fail to use the issue template, we will block you from ever submitting issues to Homebrew again.**
 
 - [ ] ran `brew update` and can still reproduce the problem?
 - [ ] ran `brew doctor`, fixed all issues and can still reproduce the problem?
@@ -12,11 +12,13 @@ about: "If you're sure it's reproducible and not just your machine: submit an is
 
 <!-- To help us debug your issue, please complete these sections: -->
 
-## What you were trying to do (and why)
+## Description
+_What you were trying to do (and why)._
 
 <!-- replace me -->
 
-## What happened (include command output)
+## Observed behavior
+_What happened (include command output)._
 
 <!-- replace me -->
 
@@ -29,15 +31,18 @@ about: "If you're sure it's reproducible and not just your machine: submit an is
   </pre>
 </details>
 
-## What you expected to happen
+## Expected behavior
+_What you expected to happen._
 
 <!-- replace me -->
 
-## Step-by-step reproduction instructions (by running `brew` commands)
+## Steps to reproduce
+_Step-by-step reproduction instructions (by running `brew` commands)._
 
 <!-- replace me -->
 
-## Output of `brew config` and `brew doctor` commands
+## System configuration
+_Output of `brew config` and `brew doctor` commands._
 
 <pre>
 <!-- replace me -->
diff --git a/.github/ISSUE_TEMPLATE/feature.md b/.github/ISSUE_TEMPLATE/feature.md
index 8651038872..080733a5e3 100644
--- a/.github/ISSUE_TEMPLATE/feature.md
+++ b/.github/ISSUE_TEMPLATE/feature.md
@@ -4,23 +4,27 @@ about: Request our thoughts on your suggestion for a new feature for Homebrew.
 
 ---
 
-# Please note we will close your issue without comment if you delete, do not read or do not fill out the issue checklist below and provide ALL the requested information. If you repeatedly fail to use the issue template, we will block you from ever submitting issues to Homebrew again.
+**Please note we will close your issue without comment if you delete, do not read or do not fill out the issue checklist below and provide ALL the requested information. If you repeatedly fail to use the issue template, we will block you from ever submitting issues to Homebrew again.**
 
 <!-- Please fill these sections with the relevant information: -->
 
-# A detailed description of the proposed feature
+## Description
+_A detailed description of the proposed feature._
 
 <!-- replace me -->
 
-# The motivation for the feature
+## Motivation
+_The motivation for the feature._
 
 <!-- replace me -->
 
-# How the feature would be relevant to at least 90% of Homebrew users
+## Relevance
+_How the feature would be relevant to at least 90% of Homebrew users._
 
 <!-- (if it's not: do not open a feature request) -->
 
-# What alternatives to the feature have been considered
+## Alternatives
+_What alternatives to the feature have been considered._
 
 <!-- replace me -->