make issue templates more minimalistic

Author: karangattu

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -1,31 +1,25 @@
 name: Bug Report
 description: Report a bug in Shiny for Python
 title: "[Bug]: "
-labels: ["bug", "needs-triage"]
+labels: ["bug"]
 body:
   - type: markdown
     attributes:
       value: |
-        Thanks for taking the time to file a bug report! Please fill out this form as completely as possible.
-
-        Providing a **Minimal Reproducible Example** is crucial for us to quickly understand and fix the issue.
-        Please take the time to create a minimal app that demonstrates the bug. Templates are provided in the "Minimal Reproducible Example" section.
-
-        **Please ensure you have searched for similar issues before submitting.** Duplicates slow down the process of fixing bugs.
+        Thanks for reporting a bug!  Please provide a **Minimal Reproducible Example** (MRE).  This is the *most important* part.  The easier it is for us to reproduce the bug, the faster we can fix it.  Search for similar issues before submitting.
 
   - type: dropdown
     id: component
     attributes:
       label: Component
-      description: Which part of Shiny for Python is affected?
+      description: Which part of Shiny is affected?
       options:
-        - UI Components (ui.*)
-        - Server Logic (server.*)
+        - UI (ui.*)
+        - Server (server.*)
         - Reactive Programming
-        - Input Bindings
-        - Output Bindings
+        - Input/Output Bindings
         - Session Management
-        - App Deployment
+        - Deployment
         - Documentation
         - Installation
         - Other
@@ -36,29 +30,28 @@ body:
     id: severity
     attributes:
       label: Severity
-      description: How severe is this issue?
       options:
-        - P0 - Critical (App crashes/unusable, blocking core functionality)
-        - P1 - High (Major feature broken, significant impact on usability)
-        - P2 - Medium (Feature works with workaround, noticeable impact)
-        - P3 - Low (Minor inconvenience, cosmetic issue, or documentation suggestion)
+        - P0 - Critical (crash/unusable)
+        - P1 - High (major feature broken)
+        - P2 - Medium (workaround exists)
+        - P3 - Low (minor inconvenience)
     validations:
       required: true
 
   - type: input
     id: version
     attributes:
       label: Shiny Version
-      description: What version of Shiny for Python are you using? (Check `shiny --version` in your terminal)
-      placeholder: ex. 1.0.2
+      description: '`shiny --version`'
+      placeholder: ex. 1.2.1
     validations:
       required: true
 
   - type: input
     id: python-version
     attributes:
       label: Python Version
-      description: What version of Python are you using? (Check `python --version` in your terminal)
+      description: '`python --version`'
       placeholder: ex. 3.10.6
     validations:
       required: true
@@ -68,106 +61,48 @@ body:
     attributes:
       label: Minimal Reproducible Example
       description: |
-        Please provide a *minimal*, self-contained Shiny app that clearly demonstrates the issue.
-        This is **the most important part** of your bug report. The easier it is for us to reproduce the bug, the faster we can fix it.
-
-        *   **Minimal:** Remove any code not directly related to the bug.
-        *   **Reproducible:** We should be able to copy and paste your code and run it to see the bug.
-        *   **Self-contained:** Include all necessary code in one file if possible.
+        A *minimal*, self-contained app demonstrating the issue.  Remove unrelated code. We should be able to copy, paste, and run it.
 
-        Templates:
+        Template:
 
         ```python
         from shiny import App, render, ui
 
-        app_ui = ui.page_fluid(
-            # Your UI code here
-        )
-
+        app_ui = ui.page_fluid()
         def server(input, output, session):
-            # Your server code here
             pass
-
         app = App(app_ui, server)
         ```
       render: python
     validations:
       required: true
 
   - type: textarea
-    id: current-behavior
-    attributes:
-      label: Current Behavior
-      description: A clear and concise description of what you are seeing happen. Be specific.
-      placeholder: When I click the button labeled "Update Plot", the app freezes and I see a spinner, but the plot does not update.
-    validations:
-      required: true
-
-  - type: textarea
-    id: expected-behavior
+    id: behavior
     attributes:
-      label: Expected Behavior
-      description: A clear and concise description of what you expected to happen instead.
-      placeholder: I expected the plot to update with new data points after clicking the "Update Plot" button, without freezing the app.
+      label: Behavior
+      description: Describe what *is* happening and what you *expected* to happen.
+      placeholder: |
+        Current: When I click..., the app freezes.
+        Expected:  The plot should update without freezing.
     validations:
-      required: true
+        required: true
 
   - type: textarea
-    id: error-messages
+    id: errors
     attributes:
       label: Error Messages (if any)
-      description: Please copy and paste any relevant error messages or tracebacks. If there are no error messages, you can leave this blank.
+      description: Copy and paste any errors/tracebacks.
       render: shell
 
   - type: textarea
     id: environment
     attributes:
-      label: Environment Information
+      label: Environment
       description: |
-        Please provide details about your development/runtime environment. This information is very helpful for debugging.
-
-        **Please fill in the details below:**
-      value: |
-        - Operating System: [e.g., Windows 10, macOS 13.4, Ubuntu 20.04]
-        - Browser: [e.g., Chrome 114, Firefox 115, Safari 16]
-        - Key Dependencies (from `pip freeze` or `conda list`):
-          - shiny: [e.g., 1.0.2]
-          - pandas: [e.g., 2.0.0]
-          - numpy: [e.g., 1.23.0]
-          - plotly: [e.g., 5.15.0]
-          - matplotlib: [e.g., 3.7.0]
-          - any other relevant packages: [e.g.,  `requests==2.28.1`]
+        - OS: [e.g., Windows 10, macOS 15.2]
+        - Browser: [e.g., Chrome 132]
+        - Dependencies:  `pip freeze` or `conda list` (especially `shiny`, `pandas`, `numpy`, etc.)
       render: markdown
     validations:
       required: true
-
-  - type: textarea
-    id: additional-context
-    attributes:
-      label: Additional Context
-      description: |
-        Add any other context or information about the problem here. This could include:
-          - Browser console logs (if relevant to UI issues)
-          - Screenshots or screen recordings
-          - Performance profiles
-          - Specific steps to reproduce the issue if your minimal example is still complex.
-
-  - type: checkboxes
-    id: terms
-    attributes:
-      label: Code of Conduct
-      description: By submitting this issue, you agree to follow our Code of Conduct. Please read it [link to Code of Conduct].
-      options:
-        - label: I agree to follow this project's Code of Conduct
-          required: true
-
-  - type: checkboxes
-    id: checks
-    attributes:
-      label: Final Checks
-      description: Before submitting, please make sure you've completed these checks to help us resolve your issue faster.
-      options:
-        - label: I have searched for similar issues in the repository to avoid duplicates.
-        - label: I have tested with the latest version of Shiny for Python to ensure the bug still exists.
-        - label: I have included a minimal reproducible example that clearly demonstrates the issue.
-        - label: I have filled out all required fields in this issue template to the best of my ability.

.github/ISSUE_TEMPLATE/documentation.yml

@@ -1,141 +1,89 @@
 name: Documentation Issue
-description: Report a documentation issue or suggest improvements
+description: Report an issue or suggest improvements to the documentation.
 title: "[Docs]: "
-labels: ["documentation", "needs-triage"]
+labels: ["documentation"]
 body:
   - type: markdown
     attributes:
       value: |
-        Thanks for helping improve Shiny for Python's documentation! Your contributions are highly valued.
-
-        Please provide as much detail as possible about the documentation issue or suggestion.
-        **Even if a field is marked as optional, providing the information is highly encouraged** to help us understand and address the issue effectively.
+        Thanks for helping improve the documentation!  Provide as much detail as possible.
 
   - type: dropdown
     id: doc-type
     attributes:
-      label: Documentation Type
-      description: What type of documentation does this issue relate to?
+      label: Type
+      description: What type of documentation?
       options:
-        - API Reference (Function/Class documentation)
-        - Tutorials/Guides (Longer, step-by-step instructions)
-        - Examples Gallery (Code examples)
-        - Getting Started (Installation, basic usage)
-        - Conceptual Guides (Explanations of core concepts)
-        - Function Docstrings (Documentation within the Python code)
+        - API Reference
+        - Tutorials/Guides
+        - Examples
+        - Getting Started
+        - Conceptual Guides
+        - Function Docstrings
         - Code Comments
-        - Installation Instructions
-        - Deployment Guides
+        - Installation
+        - Deployment
+        - Testing
         - Other
     validations:
       required: true
 
   - type: input
     id: doc-location
     attributes:
-      label: Documentation Location
-      description: Where is the documentation you're referring to? Please be as specific as possible. (URL or file path if you know it)
-      placeholder: "e.g., https://shiny.rstudio.com/py/docs/reactive-programming.html or `shiny/ui/__init__.py`"
+      label: Location
+      description: URL or file path of the documentation.
+      placeholder: "e.g., https://... or `shiny/ui/__init__.py`"
     validations:
       required: true
 
   - type: dropdown
     id: issue-type
     attributes:
-      label: Issue Type
-      description: What kind of documentation issue is this?
+      label: Issue
+      description: What kind of issue?
       options:
-        - Missing Documentation (Something is not documented)
-        - Incorrect Information (Documentation is factually wrong)
-        - Unclear Explanation (Difficult to understand)
-        - Outdated Content (Documentation is no longer current)
-        - Broken Links/References
-        - Code Example Issue (Example doesn't work or is unclear)
-        - Grammar/Typo
-        - Translation Issue (For translated documentation)
-        - Enhancement Suggestion (Improve clarity, add detail, etc.)
+        - Missing
+        - Incorrect
+        - Unclear
+        - Outdated
+        - Broken Links
+        - Code Example Issue
+        - Typo/Grammar
+        - Translation
+        - Suggestion
         - Other
     validations:
       required: true
 
-  - type: textarea
-    id: current-content
-    attributes:
-      label: Current Content (Optional, but helpful)
-      description: If applicable, please paste the relevant section of the current documentation. This helps us quickly locate the issue.
-      placeholder: |
-        Please paste the relevant current documentation text here...
-        (Leave blank if not directly applicable or for missing documentation issues)
-
   - type: textarea
     id: suggested-content
     attributes:
-      label: Suggested Changes (Highly encouraged)
+      label: Suggested Changes
       description: |
-        What changes would you like to see? Please be as specific as possible.
-        If you have a suggested text or code, please provide it here.
-
-        For code examples, use markdown code blocks:
-
+        What changes would you like to see?  Be specific. Include suggested text or code (use markdown code blocks).
+      placeholder: |
+        Provide suggested improvements or new content here...
         ```python
-        from shiny import App, ui
-        # Your example code here
+        # Example code
         ```
-      placeholder: |
-        Please provide your suggested improvements or new content here.
-        (If you have a specific wording or code example in mind, please include it here)
+    validations:
+      required: true
 
   - type: textarea
     id: motivation
     attributes:
-      label: Motivation (Optional, but helpful)
-      description: Why is this change needed? How will it help users of Shiny for Python? Explaining the impact is very helpful.
-      placeholder: |
-        Explain why this documentation improvement would be valuable...
-        (e.g., "This clarification will prevent users from misunderstanding X", "This example will make it easier to learn Y")
-
-  - type: textarea
-    id: additional-context
-    attributes:
-      label: Additional Context
-      description: Add any other context, screenshots, screen recordings, or details that might be helpful in understanding the documentation issue.
+      label: Motivation (Optional)
+      description: Why is this change needed? How will it help users?
+      placeholder: "e.g., This clarification will prevent misunderstanding..."
+    validations:
+      required: false
 
   - type: input
     id: shiny-version
     attributes:
-      label: Shiny Version (Optional, if applicable)
-      description: Which version of Shiny for Python are you using? (Only relevant if the documentation issue is version-specific)
-      placeholder: ex. 1.0.2
-
-  - type: checkboxes
-    id: preliminary-checks
-    attributes:
-      label: Preliminary Checks
-      description: Please confirm the following before submitting.
-      options:
-        - label: I have searched existing issues to avoid duplicate documentation requests.
-          required: true
-        - label: I have checked the latest documentation on the website/main branch to ensure this hasn't already been addressed.
-          required: true
-        - label: This issue is clearly a documentation issue or suggestion, and not a bug report or feature request.
-          required: true
-
-  - type: checkboxes
-    id: contribution
-    attributes:
-      label: Contribution (Optional)
-      description: Would you be interested in helping with this documentation improvement?  Your help is welcome!
-      options:
-        - label: I would be willing to submit a pull request with these changes
-          required: false
-        - label: I would be willing to review proposed changes
-          required: false
-
-  - type: checkboxes
-    id: terms
-    attributes:
-      label: Code of Conduct
-      description: By submitting this issue, you agree to follow our Code of Conduct. You can find it [link to Code of Conduct - Replace with actual link].
-      options:
-        - label: I agree to follow this project's Code of Conduct
-          required: true
+      label: Shiny Version (if applicable)
+      description: Only if the issue is version-specific.
+      placeholder: ex. 1.2.1
+    validations:
+      required: false