docs: update bug-report template and README (#2388)

Author: tatomyr

.github/ISSUE_TEMPLATE/bug_report.md

@@ -11,12 +11,15 @@ assignees: ''
 <!-- A clear and concise description of what the bug is. -->
 
 **To Reproduce**
-Steps to reproduce the behavior:
+
+<!--
+Steps to reproduce the behavior, e.g.:
 
 1. Given this `redocly.yaml` file
 2. And this OpenAPI file(s)
-3. Run this command with these arguments... `redocly ...`
-4. See error
+3. Run this command with these arguments: `redocly ...`
+4. See the error
+-->
 
 **Expected behavior**
 
@@ -28,21 +31,28 @@ Steps to reproduce the behavior:
 
 **OpenAPI description**
 
-<!-- If applicable, add an OpenAPI description and `redocly.yaml` configuration file that helps reproduce the problem.
-At a minimum, please state the specification and version(s) you're using. -->
+<!--
+If applicable, add an OpenAPI description and `redocly.yaml` configuration file that helps reproduce the problem.
+At a minimum, please state the specification and version(s) you're using.
+-->
 
-**Redocly Version(s)**
+**Redocly version(s)**
 
 <!-- What version of Redocly CLI are you using? -->
 
-**`Node.js` Version(s)**
+**Node.js version(s)**
 
-<!-- What version of `node.js` and `npm` are you using? -->
+<!-- What version of Node.js and NPM are you using? -->
 
 **OS, environment**
 
-<!-- What OS are you using? -->
+<!-- Which operating system are you using? -->
 
 **Additional context**
 
-<!-- Add any other context about the problem here. -->
+<!--
+Add any other context about the problem here, for example:
+- Are you trying to run the command for the first time?
+- Has it worked before?
+- What was the last working version?
+-->

README.md

@@ -1,7 +1,7 @@
 # Redocly CLI
 
-[@Redocly](https://redocly.com) CLI is your all-in-one OpenAPI utility.
-It builds, manages, improves, and quality-checks your OpenAPI descriptions, all of which comes in handy for various phases of the API Lifecycle.
+[@Redocly](https://redocly.com) CLI is your all-in-one API documentation utility.
+It builds, manages, improves, and quality-checks your API descriptions, all of which comes in handy for various phases of the API Lifecycle.
 Create your own rulesets to make API governance easy, publish beautiful API reference documentation, and more.
 Supports OpenAPI 3.2, 3.1, 3.0 and OpenAPI 2.0 (legacy Swagger), AsyncAPI 3.0 and 2.6, Arazzo 1.0.