diff --git a/.github/issue_template.md b/.github/issue_template.md index 5ebdb9c..21b489a 100644 --- a/.github/issue_template.md +++ b/.github/issue_template.md @@ -10,16 +10,18 @@ • Searched for existing issues (including the **closed** ones) for the similar problems here: + https://github.com/cmderdev/cmder/issues?q=is:issue - • Read the README.md and the Wiki: + • Read both the README.md and the Wiki: + - https://github.com/cmderdev/cmder/blob/master/README.md - https://github.com/cmderdev/cmder/wiki (What you may be asking here could already be explained there!) - • Please understand that Cmder by default uses ConEmu as the - underlying Terminal Emulator. If your issue is regarding + • Please understand that Cmder uses ConEmu as the default + underlying Terminal Emulator. If your issue is regarding the **Terminal Emulator**, please visit the ConEmu issues page: https://github.com/Maximus5/ConEmu/issues?q=is:issue @@ -30,35 +32,53 @@ make sure you open the issue in the correct place.) more info: https://conemu.github.io/en/ThirdPartyProblems.html - - • If you are asking for guides on how to integrate Cmder into - your favorite IDE of choice, or how to perform an specific - task with Cmder, make sure you visit our label section first! + + • If you would like to ask for guides on how to integrate Cmder with + your favorite IDE of choice, or how to perform a specific task + with Cmder, make sure you visit our label section first. + You may already have an answer under the Guides or Questions section. For a list of labels, visit: - https://github.com/cmderdev/cmder/labels (Be sure to also check “Closed” issues in the labels section!) + + • If you are having an issue with any of the **upstream technologies** + that are used by Cmder, please make sure that the issue is reproducible + _only_ when used in combination with Cmder. + + We may not directly address the issues related to the following tools: + - Clink, the default shell in Cmder + - ConEmu, the terminal emulator + - Git/MinGW, which also provide *NIX tools + - clink-completions, which provide autocomplete + + The issues related to upstream technologies are marked as 👆 [name]. + + We'll try our best to help you -- but we recommend creating an issue + specifically at each of the corresponding repositories for the best + result. + + ► Try to reproduce the bug you're reporting, on a stand-alone edition + of each tool, without using Cmder. If the bug applies when the + mentioned tools are NOT used within Cmder, there's a good chance that + you should open the bug at the corresponding repo instead. - • If the issue is regarding the other upstream technologies that - Cmder uses (e.g. Clink, Git, etc), please make sure that the - bug you are reporting only applies when they are used in - combination with Cmder. If the bug applies when the mentioned - tools are NOT used within Cmder, there's a good chance that - you should open the bug at the corresponding repo instead. + • Lastly, have a look at official documentation for Cmder over + our website, and our wiki. Read more on about Cmder on ConEmu docs: https://conemu.github.io/en/cmder.html - Thank you for making sure you are opening a new valid issue! + Thank you for making sure you are opening a new valid issue! ♥ --> @@ -74,5 +95,8 @@ - [ ] Feature request (request for new functionality) - [ ] Question +### Version Information + + ### Description of the issue