Merge pull request #209 from CommunityToolkit/llama/github-templates

Arlodotexe · web-flow · commit ed6bd2352377 · 2022-07-20T14:42:13.000-05:00
Add GitHub Templates
diff --git a/.github/ISSUE_TEMPLATE/bug.yml b/.github/ISSUE_TEMPLATE/bug.yml
@@ -0,0 +1,145 @@
+name: Bug report (Labs Infrastructure)
+description: Create a report to help us fix something within labs itself (for specific components - comment on the Experiment's issue)
+labels: ["bug :bug:"]
+body:
+- type: markdown
+  attributes: 
+    value: |
+      ## Before you begin
+      🚨 **Please do not skip instructions**🚨
+      
+      This info is essential for investigating your bug report. Issues with missing information may be closed without investigation.
+      
+      If you're uncertain about a problem, find or start a [Questions & Answers](https://github.com/CommunityToolkit/Labs-Windows/discussions/categories/q-a) discussion, where you can get insight from the community regarding your issue. 
+
+      This form is for reporting issues with the Labs infrastructure, template, or Sample app itself and not individual experiments.
+
+      If you have an issue about a specific **Experiment**, please find it's issue and comment there.
+      
+- type: textarea
+  id: description
+  validations:
+    required: true
+  attributes:
+     label: Describe the bug
+     description: A clear and concise description of what the bug is.
+- type: textarea
+  id: repro-steps
+  validations:
+    required: true
+  attributes:
+     label: Steps to reproduce
+     render: text
+     description: Provide steps to reproduce the issue, or let us know why it can't be reproduced (e.g. more complex setup, environment, dependencies, etc...)
+     placeholder: |
+        A repro from the sample app expedites the process of discovering, resolving, and validating bug fixes. 
+        Provide code-snippets or XAML snippets as appropriate.
+
+        Example repro steps:
+        1. Given the following environment (Sample App w/ XAML, Project with Isolated setup, etc...)
+        2. Go to '...'
+        3. Click on '....'
+        4. Scroll down to '....'
+        5. See error
+- type: textarea
+  id: expected-behavior
+  validations:
+    required: true
+  attributes:
+     label: Expected behavior
+     description: A clear and concise description of what you expected to happen.
+- type: textarea
+  id: screenshots
+  attributes:
+     label: Screenshots
+     description: If applicable, add screenshots to help explain your problem.
+- type: checkboxes
+  id: platform
+  attributes:
+    label: Code Platform
+    description: Check the platforms where you see the issue occur.
+    options:
+      - label: UWP
+      - label: WinAppSDK / WinUI 3
+      - label: Web Assembly (WASM)
+      - label: Android
+      - label: iOS
+      - label: MacOS
+      - label: Linux / GTK
+- type: checkboxes
+  id: environment-windows-build
+  attributes:
+     label: Windows Build Number
+     description: Check one or more of the following options (if applicable)
+     options:
+       - label: Windows 10 1809 (Build 17763)
+       - label: Windows 10 1903 (Build 18362)
+       - label: Windows 10 1909 (Build 18363)
+       - label: Windows 10 2004 (Build 19041)
+       - label: Windows 10 20H2 (Build 19042)
+       - label: Windows 10 21H1 (Build 19043)
+       - label: Windows 11 21H2 (Build 22000)
+       - label: Other (specify)
+- type: input
+  id: environment-windows-build-other-build-number
+  attributes:
+     label: Other Windows Build number
+     description: If applicable, another Windows build number not listed (such as an Insider build)
+- type: checkboxes
+  id: environment-app-min-target-version
+  attributes:
+     label: App minimum and target SDK version
+     description: Check one or more of the following options
+     options:
+       - label: Windows 10, version 1809 (Build 17763)
+       - label: Windows 10, version 1903 (Build 18362)
+       - label: Windows 10, version 1909 (Build 18363)
+       - label: Windows 10, version 2004 (Build 19041)
+       - label: Other (specify)
+- type: input
+  id: environment-app-min-target-other-build-number
+  attributes:
+     label: Other SDK version
+     description: If applicable, another SDK version not listed (such as an Insider SDK)
+- type: dropdown
+  id: visual-studio-version
+  attributes: 
+     multiple: true
+     label: Visual Studio Version
+     description: Check one or more of the following options
+     options:
+       - 2022
+       - Preview
+- type: input
+  id: visual-studio-exact-build
+  attributes:
+     label: Visual Studio Build Number
+     description: What's the exact build number? (Found in Visual Studio under Help -> About Microsoft Visual Studio)
+- type: dropdown
+  id: form-factor
+  attributes: 
+     multiple: true
+     label: Device form factor
+     description: Check one or more of the following options
+     options:
+       - Desktop
+       - Xbox
+       - Surface Hub
+       - IoT
+       - Mobile
+- type: textarea
+  id: additional-context
+  attributes:
+     label: Additional context
+     description: Add any other context about the problem here.
+- type: dropdown
+  id: contribution
+  validations:
+    required: true
+  attributes:
+     label: Help us help you
+     description: Would you like to contribute a solution to this issue?
+     options:
+       - Yes, I'd like to be assigned to work on this item.
+       - Yes, but only if others can assist.
+       - No, I'm unable to contribute a solution.
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
@@ -0,0 +1,17 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Issue with Existing Experiment
+    url: https://github.com/CommunityToolkit/Labs-Windows/issues?q=is%3Aopen+is%3Aissue+label%3A%22experiment+%3Atest_tube%3A%22
+    about: Please comment on existing Experiment issues with any problems which arise during their use.
+  - name: New Idea?
+    url: https://github.com/CommunityToolkit/Labs-Windows/discussions?discussions_q=category%3AExperiments+category%3AIdeas
+    about: Search existing experiments and ideas or contribute your own in our Discussion forum.
+  - name: Not sure where to start? Start a Discussion!
+    url: https://github.com/CommunityToolkit/Labs-Windows/discussions
+    about: I have a question about how to use something in the toolkit.    
+  - name: Discord
+    url: https://aka.ms/wct/discord
+    about: "Join the UWP Discord Server and talk to us in the #community-toolkit channel."
+  - name: Toolkit Questions
+    url: https://github.com/CommunityToolkit/WindowsCommunityToolkit/discussions/categories/questions-help
+    about: If you have general questions about how to use something in the toolkit, outside of Labs, see the main repo discussions.
diff --git a/.github/ISSUE_TEMPLATE/experiment.yml b/.github/ISSUE_TEMPLATE/experiment.yml
@@ -0,0 +1,113 @@
+name: Experiment Tracking Form
+description: (w/ Approved Discussion) Create an issue to track an approved experiment
+title: "🧪 [Experiment]"
+labels: ["experiment :test_tube:"]
+body:
+- type: markdown
+  attributes: 
+    value: |
+      ## Before you begin
+      🚨 **Please do not skip instructions**🚨
+      
+      This template is to be used with an approved experiment proposal in the [Discussions](https://github.com/CommunityToolkit/Labs-Windows/discussions).
+
+      This info is essential to help us process your experiment.
+
+- type: input
+  id: linked-discussion
+  validations:
+    required: true
+  attributes:
+    label: Approved from Discussion
+    description: Paste in a link to your approved discussion from https://github.com/CommunityToolkit/Labs-Windows/discussions
+    placeholder: "https://github.com/CommunityToolkit/Labs-Windows/discussions/###"
+    
+- type: textarea
+  id: problem-statement
+  validations: 
+    required: true
+  attributes: 
+    label: Problem Statement
+    description: Copy your problem statement description from your approved discussion.
+    placeholder: |
+      A clear and concise description of what the problem the experiment solves, starting with the user story.
+
+- type: textarea
+  id: overview-description
+  validations: 
+    required: true
+  attributes: 
+    label: Overview
+    description: What components/functions does this experiment add?
+    value: |
+      This experiment adds the following components:
+       - **Component One** a ...
+       - **Component Two** a ...
+
+- type: textarea
+  id: using-links
+  validations:
+    required: true
+  attributes: 
+    label: Using
+    description: Describe how to try out your component
+    value: |
+      You can try it out via the NuGet Packages here:
+       - UWP: https://dev.azure.com/dotnet/CommunityToolkit/_artifacts/feed/CommunityToolkit-Labs/NuGet/CommunityToolkit.Labs.Uwp.ExperimentName/overview/0.0.1
+       - WinUI 3: https://dev.azure.com/dotnet/CommunityToolkit/_artifacts/feed/CommunityToolkit-Labs/NuGet/CommunityToolkit.Labs.WinUI.ExperimentName/overview/0.0.1
+      Read more about [Preview Packages here](https://aka.ms/wct/wiki/previewpackages).
+
+- type: textarea
+  id: additional-info
+  attributes:
+    label: Additional info
+    description: Add any other context or screenshots about the feature request here.
+
+- type: checkboxes
+  id: implementation-requirements
+  attributes:
+    label: Implementation Requirements
+    description: Not all these items are required to submit a PR. This list is here to help track what is remaining to implement before a technical review and discussion of moving into the main repository can occur.
+    options:
+      - label: Working Prototype
+      - label: Feature Complete
+      - label: Documentation
+      - label: Samples
+      - label: Unit Tests
+      - label: Community Feedback / Usage Testimonies
+
+- type: checkboxes
+  id: tested-platforms
+  attributes:
+    label: Tested Platforms
+    description: Which platforms has your current experiment code been tested with (by you or someone in the community)?
+    options:
+      - label: UWP
+      - label: WinAppSDK / WinUI 3
+      - label: Web Assembly (WASM)
+      - label: Android
+      - label: iOS
+      - label: MacOS
+      - label: Linux / GTK
+
+- type: checkboxes
+  id: technical-review
+  attributes:
+    label: Technical Review
+    description: These items can sometimes be done ahead of time, but are usually started and completed after all implementation details are finished. You can _skip_ this section for now when opening a new experiment, though it's good to be familiar with these work items.
+    options:
+      - label: Accessibility Audit
+      - label: API/Naming Review
+      - label: Code Quality/Style
+      - label: Dependency Review
+      - label: Design/Style Review
+      - label: Final Approval
+
+- type: dropdown
+  id: contribution
+  attributes:
+    label: Community Help?
+    description: Would you like others to help you work on the deliverables for this experiment?
+    options:
+      - Yes
+      - No
