Merge branch 'main' into patch-6

Author: catplat

.github/ISSUE_TEMPLATE/config.yml

@@ -1 +1,8 @@
 blank_issues_enabled: false # Force people to start from a template
+contact_links:
+  - name: "Upsun Support - open a Support ticket" 
+    url: https://console.upsun.com/-/users/~/tickets/open
+    about: If you're experiencing problems with the Upsun Flex or Fixed product offerings, please open a support ticket.
+  - name: "Upsun Discord - questions and messages"
+    url: https://discord.gg/upsun
+    about: For questions and discussion about Upsun Flex or Upsun Fixed product offerings, message us on Discord!

.github/ISSUE_TEMPLATE/improvements.yml

@@ -1,35 +1,49 @@
-name: Improvements
-description: For changes to improve existing content.
+name: 'Docs - Improvements and corrections'
+description: Suggest changes to improve or correct the existing Upsun Flex or Fixed content
 labels:
   - ungroomed
 body:
   - type: markdown
     attributes:
       value: |
-        Thanks for your interest in helping improve the Platform.sh docs!
-        Please fill in the fields below so we can understand what changes are needed.
+        Please complete the fields below to help us improve the Upsun docs.
+  - type: dropdown
+    id: priority
+    validations:
+      required: true
+    attributes:
+      label: Priority
+      description: How urgent is this update?
+      options:
+        - 1 - Urgent - customers are affected; causes support issues
+        - 2 - Important - inaccurate info needs to be corrected to prevent customer issues
+        - 3 - Not urgent - can be addressed as team bandwidth permits
+        - 4 - Nice-to-have - ideal, but not mandatory
+        - 5 - Unsure - Docs/Advocacy team will assess 
+      default: 2
 
   - type: textarea
     attributes:
-      label: Where on docs.platform.sh should be changed?
-      description: Link to the pages you think should be updated.
-      placeholder: https://docs.platform.sh/
+      label: Where should the changes be made?
+      description: Add the links to the Upsun Flex and/or Upsun Fixed pages you think should be updated.
+      placeholder: https://docs.upsun.com, https://fixed.docs.upsun.com/
     validations:
       required: true
 
   - type: textarea
     attributes:
       label: What exactly should be updated?
       description: |
-        - Share as much detail as you can to help us understand the suggestion. 
-        - What is written now that shouldn't be or isn't written that should be?
-        - What do you expect as an outcome?
+        - **Do not** include Upsun-internal information, Slack threads, etc. in this field.
+        - What needs to be added, removed, or updated? Please provide as much detail as possible. 
+        - Include expected outcomes that users will find useful. 
+        - Include additional guidance that prevent unexpected outcomes for users.
     validations:
       required: true
 
   - type: textarea
     attributes:
-      label: Additional context
-      description: Optionally add any other information or screenshots that could help us understand and implement the change.
+      label: 'Optional: Additional context'
+      description: Include other information or screenshots that could help us understand and implement the change.
     validations:
       required: false

.github/ISSUE_TEMPLATE/new_docs.yml

@@ -1,26 +1,69 @@
-name: New docs
-description: For adding documentation that doesn't yet exist, such as for a new feature.
+name: 'Docs - New documentation request'
+description: Propose new documentation (new features, new guides, etc.)
 labels:
   - ungroomed
 body:
   - type: markdown
     attributes:
       value: |
-        Thanks for helping improve the Platform.sh docs!
-        Please fill in the fields below so we can understand what documentation is needed.
+        Please complete the fields below to help us improve the Upsun docs.
+
+  - type: dropdown
+    id: offering
+    validations:
+      required: true
+    attributes:
+      label: Offering
+      multiple: true
+      description: Which offering is impacted by the feature? (select all that apply)
+      options:
+        - Upsun Flex
+        - Upsun Fixed
+      default: 0,1
 
   - type: textarea
     attributes:
       label: What needs to be documented?
       description: |
-        Describe in detail what is missing from the documentation.
-        Include the use case for the missing feature: why people want to use it.
+        - **Do not** include Upsun-internal information, Slack threads, etc. in this field.
+        - Include information such as key use cases, benefits to the user, business problem solved, etc.
+        - Include expected outcomes that users will find useful. 
+        - Include guidance that will prevent negative or unexpected outcomes for users.
     validations:
       required: true
 
+  - type: dropdown
+    id: docs_impact
+    attributes:
+      multiple: true
+      label: Docs impact
+      description: Where do you believe these docs should be placed? For further comments, use the Additional context field later in this form.
+      options:
+        - "Get started materials or framework-specific guides"
+        - "Learn: tutorials & best practices"
+        - "Frameworks (Fixed only)"
+        - "Reference > Configure apps"
+        - "Reference > Add services"
+        - "Reference > Define routes"
+        - "Reference > Languages"
+        - "Reference > Development"
+        - "Reference > Integrations"
+        - "Reference > Increase observability"
+        - "Reference > Managing manage enviornments/projects"
+        - "Reference > Custom domains"
+        - "Reference > Administration"
+        - "Reference > Security and compliance"
+        - "Reference > Dedicated 2 (Fixed only)"
+        - "Reference > Manage resources (Flex only)"
+        - "Reference > Glossary"
+      default: 0
+    validations:
+      required: false
+
   - type: textarea
     attributes:
-      label: Additional context
-      description: Optionally add any other information or screenshots that could help us understand what to document.
+      label: 'Optional: Additional context'  
+      description: Include other information or screenshots that could help us understand and implement the change.
     validations:
       required: false
+