diff options
author | Titus Wormer <tituswormer@gmail.com> | 2022-08-19 16:51:02 +0200 |
---|---|---|
committer | Titus Wormer <tituswormer@gmail.com> | 2022-08-19 16:51:02 +0200 |
commit | a5eded4abde26afdd4e1b32115b58671d6cf740b (patch) | |
tree | c5a5e1bb362a899cb73d9c0a7e5307cfb5585b08 /.github/support.md | |
parent | dc974ed38c5ed360829fbb573ddbdb797889c7fd (diff) | |
download | markdown-rs-a5eded4abde26afdd4e1b32115b58671d6cf740b.tar.gz markdown-rs-a5eded4abde26afdd4e1b32115b58671d6cf740b.tar.bz2 markdown-rs-a5eded4abde26afdd4e1b32115b58671d6cf740b.zip |
Add contributing, support guide
Diffstat (limited to '.github/support.md')
-rw-r--r-- | .github/support.md | 46 |
1 files changed, 46 insertions, 0 deletions
diff --git a/.github/support.md b/.github/support.md new file mode 100644 index 0000000..7fd182d --- /dev/null +++ b/.github/support.md @@ -0,0 +1,46 @@ +# Support + +This article explains how and where to get help. +Please read through the following guidelines. + +## Asking quality questions + +Questions can go to [GitHub discussions][chat]. + +Help us help you! +Spend time framing questions and add links and resources. +Spending the extra time up front helps save everyone time in the long run. +Here are some tips: + +- see [this article on _How do I ask a good question_][how-to-ask] for help +- [talk to a duck][rubberduck]! +- don’t fall for the [XY problem][xy] +- search to find out if a similar question has been asked +- try to define what you need help with: + - is there something in particular you want to do? + - what problem are you encountering and what steps have you taken to try + and fix it? + - is there a concept you don’t understand? +- provide sample code, if possible +- screenshots can help, but if there’s important text such as code or error + messages in them, please also provide those as text +- the more time you put into asking your question, the better we can help you + +## Contributions + +See [`contributing.md`][contributing] on how to contribute. + +## License + +[CC-BY-4.0][license] © [Titus Wormer][author] + +<!-- Definitions --> + +[license]: https://creativecommons.org/licenses/by/4.0/ +[author]: https://wooorm.com +[coc]: https://github.com/remarkjs/.github/blob/main/code-of-conduct.md +[rubberduck]: https://rubberduckdebugging.com +[xy]: https://meta.stackexchange.com/questions/66377/what-is-the-xy-problem/66378#66378 +[chat]: https://github.com/remarkjs/remark/discussions +[contributing]: contributing.md +[how-to-ask]: https://stackoverflow.com/help/how-to-ask |