conda · jezdez · Aug 2, 2024 · Aug 2, 2024 · Aug 2, 2024
@@ -6,25 +6,25 @@ on:
   push:
     branches: [main]
     paths:
-      - .github/ISSUE_TEMPLATE/0_bug.yml
-      - .github/ISSUE_TEMPLATE/1_feature.yml
-      - .github/ISSUE_TEMPLATE/epic.yml
-      - .github/ISSUE_TEMPLATE/2_documentation.yml
-      - .github/PULL_REQUEST_TEMPLATE/with_releases.md
-      - .github/PULL_REQUEST_TEMPLATE/without_releases.md
-      - .github/sync/config.yml  # trigger sync if config is modified
-      - .github/sync/RELEASE.md
-      - .github/sync/rever.xsh
-      - .github/sync/TEMPLATE
+      - sync/ISSUE_TEMPLATE/0_bug.yml
+      - sync/ISSUE_TEMPLATE/1_feature.yml
+      - sync/ISSUE_TEMPLATE/epic.yml
+      - sync/ISSUE_TEMPLATE/2_documentation.yml
+      - sync/PULL_REQUEST_TEMPLATE/with_releases.md
+      - sync/PULL_REQUEST_TEMPLATE/without_releases.md
+      - sync/config.yml  # trigger sync if config is modified
+      - templates/releases/RELEASE.md
+      - templates/releases/rever.xsh
+      - templates/releases/TEMPLATE
       - .github/workflows/cla.yml
       - .github/workflows/issues.yml
       - .github/workflows/labels.yml
       - .github/workflows/lock.yml
       - .github/workflows/project.yml
       - .github/workflows/stale.yml
       - .github/workflows/sync.yml  # trigger sync if workflow is modified
-      - CODE_OF_CONDUCT.md
-      - HOW_WE_USE_GITHUB.md
+      - sync/CODE_OF_CONDUCT.md
+      - sync/HOW_WE_USE_GITHUB.md
 
   # NOTE: github.event is workflow_dispatch payload:
   # https://docs.github.com/en/developers/webhooks-and-events/webhooks/webhook-events-and-payloads#workflow_dispatch

@@ -0,0 +1,20 @@
+# Conda Organization Code of Conduct
+
+> [!NOTE]
+> Below is the short version of our CoC, see the long version [here](https://github.com/conda/governance/blob/main/CODE_OF_CONDUCT.md).
+
+# The Short Version
+
+Be kind to others. Do not insult or put down others. Behave professionally. Remember that harassment and sexist, racist, or exclusionary jokes are not appropriate for the conda Organization.
+
+All communication should be appropriate for a professional audience including people of many different backgrounds. Sexual language and imagery is not appropriate.
+
+The conda Organization is dedicated to providing a harassment-free community for everyone, regardless of gender, sexual orientation, gender identity and expression, disability, physical appearance, body size, race, or religion. We do not tolerate harassment of community members in any form.
+
+Thank you for helping make this a welcoming, friendly community for all.
+
+## Report an Incident
+
+* Report a code of conduct incident [using a form](https://form.jotform.com/221527028480048).
+* Report a code of conduct incident via email: [conduct@conda.org](mailto:conduct@conda.org).
+* Contact [an individual committee member](#committee-membership) or [CoC event representative](#coc-representatives) to report an incident in confidence.
@@ -0,0 +1,77 @@
+name: Bug Report
+description: Create a bug report.
+labels:
+  - type::bug
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Because processing new bug reports is time-consuming, we would like to ask you to fill out the following form to the best of your ability and as completely as possible.
+
+        > [!NOTE]
+        > Bug reports that are incomplete or missing information may be closed as inactionable.
+
+        Since there are already a lot of open issues, please also take a moment to search existing ones to see if your bug has already been reported. If you find something related, please upvote that issue and provide additional details as necessary.
+
+        💐 Thank you for helping to make Conda better. We would be unable to improve Conda without our community!
+  - type: checkboxes
+    id: checks
+    attributes:
+      label: Checklist
+      description: Please confirm and check all of the following options.
+      options:
+        - label: I added a descriptive title
+          required: true
+        - label: I searched open reports and couldn't find a duplicate
+          required: true
+  - type: textarea
+    id: what
+    attributes:
+      label: What happened?
+      description: What should have happened instead? Please provide as many details as possible. The more information provided, the more likely we are able to replicate your problem and offer a solution.
+    validations:
+      required: true
+  - type: textarea
+    id: info
+    attributes:
+      label: Conda Info
+      description: |
+        Let's collect some basic information about your conda install.
+
+        Please run the following command from your command line and paste the output below.
+
+        ```bash
+        conda info
+        ```
+      render: shell
+  - type: textarea
+    id: config
+    attributes:
+      label: Conda Config
+      description: |
+        Let's collect any customizations you may have for your conda install.
+
+        Please run the following command from your command line and paste the output below.
+
+        ```bash
+        conda config --show-sources
+        ```
+      render: shell
+  - type: textarea
+    id: list
+    attributes:
+      label: Conda list
+      description: |
+        The packages installed into your environment can offer clues as to the problem you are facing.
+
+        Please activate the environment within which you are encountering this bug, run the following command from your command line, and paste the output below.
+
+        ```bash
+        conda list --show-channel-urls
+        ```
+      render: shell
+  - type: textarea
+    id: context
+    attributes:
+      label: Additional Context
+      description: Include any additional information (or screenshots) that you think would be valuable.
@@ -0,0 +1,48 @@
+name: Feature Request
+description: Create a feature request.
+labels:
+  - type::feature
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Because processing new feature requests is time-consuming, we would like to ask you to fill out the following form to the best of your ability and as completely as possible.
+
+        > [!NOTE]
+        > Feature requests that are incomplete or missing information may be closed as inactionable.
+
+        Since there are already a lot of open issues, please also take a moment to search existing ones to see if your feature request has already been submitted. If you find something related, please upvote that issue and provide additional details as necessary.
+
+        💐 Thank you for helping to make Conda better. We would be unable to improve Conda without our community!
+  - type: checkboxes
+    id: checks
+    attributes:
+      label: Checklist
+      description: Please confirm and check all of the following options.
+      options:
+        - label: I added a descriptive title
+          required: true
+        - label: I searched open requests and couldn't find a duplicate
+          required: true
+  - type: textarea
+    id: idea
+    attributes:
+      label: What is the idea?
+      description: Describe what the feature is and the desired state.
+    validations:
+      required: true
+  - type: textarea
+    id: why
+    attributes:
+      label: Why is this needed?
+      description: Who would benefit from this feature? Why would this add value to them? What problem does this solve?
+  - type: textarea
+    id: what
+    attributes:
+      label: What should happen?
+      description: What should be the user experience with the feature? Describe from a user perspective what they would do and see.
+  - type: textarea
+    id: context
+    attributes:
+      label: Additional Context
+      description: Include any additional information that you think would be valuable.
@@ -0,0 +1,36 @@
+name: Documentation
+description: Create a documentation related issue.
+labels:
+  - type::documentation
+body:
+  - type: markdown
+    attributes:
+      value: |
+        > [!NOTE]
+        > Documentation requests that are incomplete or missing information may be closed as inactionable.
+
+        Since there are already a lot of open issues, please also take a moment to search existing ones to see if your bug has already been reported. If you find something related, please upvote that issue and provide additional details as necessary.
+
+        💐 Thank you for helping to make conda better. We would be unable to improve conda without our community!
+  - type: checkboxes
+    id: checks
+    attributes:
+      label: Checklist
+      description: Please confirm and check all of the following options.
+      options:
+        - label: I added a descriptive title
+          required: true
+        - label: I searched open reports and couldn't find a duplicate
+          required: true
+  - type: textarea
+    id: what
+    attributes:
+      label: What happened?
+      description: Mention here any typos, broken links, or missing, incomplete, or outdated information, etc. that you have noticed in the conda docs or CLI help.
+    validations:
+      required: true
+  - type: textarea
+    id: context
+    attributes:
+      label: Additional Context
+      description: Include any additional information (or screenshots) that you think would be valuable.
@@ -0,0 +1,105 @@
+name: Epic
+description: A collection of related tickets.
+labels:
+  - epic
+body:
+  - type: markdown
+    attributes:
+      value: |
+        This form is intended for grouping and collecting together related tickets to better gauge the scope of a problem/feature.
+
+        If you are attempting to report a bug, propose a new feature, or some other code change please use one of the other forms available.
+
+        > [!NOTE]
+        > Epics that are incomplete or missing information may be closed as inactionable.
+
+        Since there are already a lot of open issues, please also take a moment to search existing ones to see if a similar epic has already been opened. If you find something related, please upvote that issue and provide additional details as necessary.
+
+        💐 Thank you for helping to make Conda better. We would be unable to improve Conda without our community!
+  - type: checkboxes
+    id: checks
+    attributes:
+      label: Checklist
+      description: Please confirm and check all of the following options.
+      options:
+        - label: I added a descriptive title
+          required: true
+        - label: I searched open issues and couldn't find a duplicate
+          required: true
+
+  - type: textarea
+    id: what
+    attributes:
+      label: What?
+      description: >-
+        What feature or problem will be addressed in this epic?
+      placeholder: Please describe here.
+    validations:
+      required: true
+
+  - type: textarea
+    id: why
+    attributes:
+      label: Why?
+      description: >-
+        Why is the reported issue(s) a problem, or why is the proposed feature needed?
+        (Research and spike issues can be linked here.)
+      value: |
+        - [ ] <supporting issue from user, research, or spike>
+      placeholder: Please describe here and/or link to relevant supporting issues.
+    validations:
+      required: true
+
+  - type: textarea
+    id: user_impact
+    attributes:
+      label: User impact
+      description: >-
+        In what specific way(s) will users benefit from this change? (e.g. use cases or performance improvements)
+      placeholder: Please describe here.
+    validations:
+      required: true
+
+  - type: textarea
+    id: goals
+    attributes:
+      label: Goals
+      description: >-
+        What goal(s) should this epic accomplish?
+      value: |
+        - [ ] <goal>
+    validations:
+      required: true
+
+  - type: textarea
+    id: tasks
+    attributes:
+      label: Tasks
+      description: >-
+        What needs to be done to implement this change?
+      value: |
+        - [ ] <task or PR>
+    validations:
+      required: false
+
+  - type: textarea
+    id: blocked_by
+    attributes:
+      label: 'This epic is blocked by:'
+      description: >-
+        Epics and issues that block this epic.
+      value: |
+        - [ ] <dependency epic or issue>
+    validations:
+      required: false
+
+  - type: textarea
+    id: blocks
+    attributes:
+      label: 'This epic blocks:'
+      description: >-
+        Epics and issues that are blocked by this epic.
+      value: |
+        - [ ] <dependency epic or issue>
+    validations:
+      required: false
@@ -43,16 +43,16 @@ group:
       - source: .github/workflows/cla.yml
         dest: .github/workflows/cla.yml
       # issue forms
-      - source: .github/ISSUE_TEMPLATE/0_bug.yml
+      - source: sync/ISSUE_TEMPLATE/0_bug.yml
         dest: .github/ISSUE_TEMPLATE/0_bug.yml
-      - source: .github/ISSUE_TEMPLATE/1_feature.yml
+      - source: sync/ISSUE_TEMPLATE/1_feature.yml
         dest: .github/ISSUE_TEMPLATE/1_feature.yml
-      - source: .github/ISSUE_TEMPLATE/epic.yml
+      - source: sync/ISSUE_TEMPLATE/epic.yml
         dest: .github/ISSUE_TEMPLATE/epic.yml
-      - source: .github/ISSUE_TEMPLATE/2_documentation.yml
+      - source: sync/ISSUE_TEMPLATE/2_documentation.yml
         dest: .github/ISSUE_TEMPLATE/2_documentation.yml
       # issue sorting
-      - source: HOW_WE_USE_GITHUB.md
+      - source: sync/HOW_WE_USE_GITHUB.md
         dest: HOW_WE_USE_GITHUB.md
   # projects with releases
   - repos: |
@@ -74,7 +74,7 @@ group:
       conda/schemas
     files:
       # PR template
-      - source: .github/PULL_REQUEST_TEMPLATE/with_releases.md
+      - source: sync/PULL_REQUEST_TEMPLATE/with_releases.md
         dest: .github/PULL_REQUEST_TEMPLATE.md
       # news snippet template
       - source: templates/releases/TEMPLATE
@@ -88,7 +88,7 @@ group:
       conda/issue-tracker
     files:
       # PR template
-      - source: .github/PULL_REQUEST_TEMPLATE/without_releases.md
+      - source: sync/PULL_REQUEST_TEMPLATE/without_releases.md
         dest: .github/PULL_REQUEST_TEMPLATE.md
   # projects with rever releases
   - repos: |
@@ -133,5 +133,5 @@ group:
       conda/pycosat
       conda/schemas
     files:
-      - source: CODE_OF_CONDUCT.md
+      - source: sync/CODE_OF_CONDUCT.md
         dest: CODE_OF_CONDUCT.md