diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md new file mode 100644 index 0000000000..adddd33468 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/bug_report.md @@ -0,0 +1,25 @@ +--- +name: Bug report +about: Report an issue +title: '' +labels: bug +assignees: '' + +--- + +* Remove all placeholder text below before submitting. + +* Please search existing issues before raising a new issue. For questions about MicroPython or for help using MicroPython, please see the MicroPython Forum -- https://forum.micropython.org/ + +* In your issue, please include a clear and concise description of what the bug is, the expected output, and how to replicate it. + +* If this issue involves external hardware, please include links to relevant datasheets and schematics. + +* If you are seeing code being executed incorrectly, please provide a minimal example and expected output (e.g. comparison to CPython). + +* For build issues, please include full details of your environment, compiler versions, command lines, and build output. + +* Please provide as much information as possible about the version of MicroPython you're running, such as: + - firmware file name + - git commit hash and port/board + - version information shown in the REPL (hit Ctrl-B to see the startup message) diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml new file mode 100644 index 0000000000..318d9416ee --- /dev/null +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -0,0 +1,11 @@ +blank_issues_enabled: false +contact_links: + - name: MicroPython Forum + url: https://forum.micropython.org/ + about: Community discussion about all things MicroPython. This is the best place to start if you have questions about using MicroPython or getting started with MicroPython development. + - name: MicroPython Documentation + url: https://docs.micropython.org/ + about: Documentation for using and working with MicroPython and libraries. + - name: MicroPython Downloads + url: https://micropython.org/download/ + about: Pre-built firmware and information for most supported boards. diff --git a/.github/ISSUE_TEMPLATE/documentation.md b/.github/ISSUE_TEMPLATE/documentation.md new file mode 100644 index 0000000000..84ff2ba6f1 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/documentation.md @@ -0,0 +1,16 @@ +--- +name: Documentation issue +about: Report areas of the documentation or examples that need improvement +title: 'docs: ' +labels: documentation +assignees: '' + +--- + +* Remove all placeholder text below before submitting. + +* Please search existing issues before raising a new issue. For questions about MicroPython or for help using MicroPython, please see the MicroPython Forum -- https://forum.micropython.org/ + +* Describe what was missing from the documentation and/or what was incorrect/incomplete. + +* If possible, please link to the relevant page on https://docs.micropython.org/ diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md new file mode 100644 index 0000000000..1ac2055e01 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/feature_request.md @@ -0,0 +1,24 @@ +--- +name: Feature request +about: Request a feature or improvement +title: '' +labels: enhancement +assignees: '' + +--- + +* Remove all placeholder text below before submitting. + +* Please search existing issues before raising a new issue. For questions about MicroPython or for help using MicroPython, please see the MicroPython Forum -- https://forum.micropython.org/ + +* Describe the feature you'd like to see added to MicroPython. In particular, what does this feature enable and why is it useful. MicroPython aims to strike a balance between functionality and code size, so please consider whether this feature can be optionally enabled and whether it can be provided in other ways (e.g. pure-Python library). + +* For core Python features, where possible please include a link to the relevant PEP. + +* For new architectures / ports / boards, please provide links to relevant documentation, specifications, and toolchains. Any information about the popularity and unique features about this hardware would also be useful. + +* For features for existing ports (e.g. new peripherals or microcontroller features), please describe which port(s) it applies too, and whether this is could be an extension to the machine API or a port-specific module? + +* For drivers (e.g. for external hardware), please link to datasheets and/or existing drivers from other sources. + +* Who do you expect will implement the feature you are requesting? Would you be willing to sponsor this work? diff --git a/.github/ISSUE_TEMPLATE/security.md b/.github/ISSUE_TEMPLATE/security.md new file mode 100644 index 0000000000..fe60875f70 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/security.md @@ -0,0 +1,16 @@ +--- +name: Security report +about: Report a security issue or vunerability in MicroPython +title: '' +labels: security +assignees: '' + +--- + +* Remove all placeholder text before submitting the new issue. + +* If you need to raise this issue privately with the MicroPython team, please email contact@micropython.org instead. + +* Include a clear and concise description of what the security issue is. + +* What does this issue allow an attacker to do?