📝

.github/ISSUE_TEMPLATE/improve-existing-docs.yaml

@@ -1,32 +1,31 @@
-name: Improve existing content
+name: Improve existing content.
-description: Make a suggestion to improve the content in an existing article
+description: Make a suggestion to improve the content in an existing article.
-title: '[What I really want the title to be]'
+title: '[What I really want the title to be]':
 labels:
   - content
 body:
   - type: markdown
     attributes:
       value: |
-        **HUBBERS!! THIS IS GITHUB/DOCS OPEN SOURCE REPO. OPEN AN ISSUE IN GITHUB/DOCS-CONTENT INSTEAD.**
+        **HUBBERS!!** This is the github/docs open source repo. You may want to open an issue in the internal-only github/docs-content repo instead.
 
-        * For questions, ask in [Discussions](https://github.com/github/docs/discussions)
+        * For questions, ask in [Discussions](https://github.com/github/docs/discussions).
-        * Before you file an issue read the [Contributing guide](https://github.com/github/docs/blob/main/CONTRIBUTING.md)
+        * Before you file an issue read the [Contributing guide](https://github.com/github/docs/blob/main/CONTRIBUTING.md).
-        * Check to make sure someone hasn't already opened a similar [issue](https://github.com/github/docs/issues)
+        * Check to make sure someone hasn't already opened a similar [issue](https://github.com/github/docs/issues).
 
   - type: checkboxes
     id: terms
     attributes:
       label: Code of Conduct
-      description: By submitting this issue, you agree to follow our [Code of Conduct](https://example.com)
+      description: By submitting this issue, you agree to follow our [Code of Conduct](https://example.com).
       options:
-        - label: I agree to follow this project's Code of Conduct
+        - label: I agree to follow this project's Code of Conduct.
           required: true
 
   - type: textarea
     attributes:
       label: What article on docs.github.com is affected?
-      description: |
+      description: Please link to the article you'd like to see updated.
-        Please link to the article you'd like to see updated
     validations:
       required: true
 
@@ -43,7 +42,6 @@ body:
   - type: textarea
     attributes:
       label: Additional information
-      description: |
+      description: Add any other context or screenshots about the feature request here.
-        Add any other context or screenshots about the feature request here.
     validations:
       required: false

.github/ISSUE_TEMPLATE/improve-the-site.yml

@@ -7,25 +7,24 @@ body:
   - type: markdown
     attributes:
       value: |
-        **HUBBERS!! THIS IS GITHUB/DOCS OPEN SOURCE REPO. OPEN AN ISSUE IN GITHUB/DOCS-CONTENT INSTEAD.**
+        **HUBBERS!!** This is the github/docs open source repo. You may want to open an issue in the internal-only github/docs-content repo instead.
 
-        * For questions, ask in [Discussions](https://github.com/github/docs/discussions)
+        * For questions, ask in [Discussions](https://github.com/github/docs/discussions).
-        * Before you file an issue read the [Contributing guide](https://github.com/github/docs/blob/main/CONTRIBUTING.md)
+        * Before you file an issue read the [Contributing guide](https://github.com/github/docs/blob/main/CONTRIBUTING.md).
-        * Check to make sure someone hasn't already opened a similar [issue](https://github.com/github/docs/issues)
+        * Check to make sure someone hasn't already opened a similar [issue](https://github.com/github/docs/issues).
 
   - type: checkboxes
     attributes:
-      label: Code of Conduct
+      label: Code of Conduct.
-      description: By submitting this issue, you agree to follow our [Code of Conduct](https://example.com)
+      description: By submitting this issue, you agree to follow our [Code of Conduct](https://example.com).
       options:
-        - label: I agree to follow this project's Code of Conduct
+        - label: I agree to follow this project's Code of Conduct.
           required: true
 
   - type: textarea
     attributes:
       label: What article on docs.github.com is affected?
-      description: |
+      description: Include links to articles where you're seeing a problem, screenshots, what browser you're using, etc.
-        Include links to articles where you're seeing a problem, screenshots, what browser you're using, etc.
     validations:
       required: true
 
@@ -42,7 +41,6 @@ body:
   - type: textarea
     attributes:
       label: Additional information
-      description: |
+      description: Any additional information, configuration, or data that might be necessary to reproduce the issue.
-        Any additional information, configuration, or data that might be necessary to reproduce the issue.
     validations:
       required: false

.github/ISSUE_TEMPLATE/partner-contributed-documentation.yml

@@ -1,6 +1,6 @@
-name: Partner-owned product documentation
+name: Partner-owned product documentation.
-description: Initiate a set of tasks to be completed by a GitHub partner wishing to document how their product works with GitHub
+description: Initiate a set of tasks to be completed by a GitHub partner wishing to document how their product works with GitHub.
-title: "'[What I really want the title to be]': "
+title: '[What I really want the title to be]': 
 labels:
   - partner
 body:
@@ -57,4 +57,4 @@ body:
     attributes:
       value: |
         Once all tasks are completed, please mention `@github/docs-content` for next steps.
-        /cc @github/partner-engineering for :eyes:
+        /cc @github/partner-engineering for :eyes:.