From 4d390e5e6fa7f4d29f5c379d529993a7a656ae50 Mon Sep 17 00:00:00 2001 From: Tobias Weimer Date: Mon, 17 Jul 2017 18:40:13 +0200 Subject: Add a CONTRIBUTING.md to our Github site (#861) * Create CONTRIBUTING.md * Update CONTRIBUTING.md * Create ISSUE_TEMPLATE.md * Update ISSUE_TEMPLATE.md * Update CONTRIBUTING.md Use a clean profile or make a backup of your working profile. It may not be possible to downgrade without data loss! --- CONTRIBUTING.md | 31 +++++++++++++++++++++++++++++++ ISSUE_TEMPLATE.md | 12 ++++++++++++ 2 files changed, 43 insertions(+) create mode 100644 CONTRIBUTING.md create mode 100644 ISSUE_TEMPLATE.md diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000000..c667755de6 --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,31 @@ +## Before reporting a bug +* Update to the latest *development version* (**caution:** Use a clean profile or make a backup of your working profile. It may not be possible to downgrade without data loss!). +* Check if the problem persists (it may happen that it has been fixed). +* Search the *issues* for an existing bug report for your problem. + +## Effective bug reporting +Using the following tips will **greatly** increase the chances of your issue being '''noticed''' and '''fixed''' quickly. + +* Have a well-written bug **Summary** field – describe the issue clearly, in simple words. +* **Description** field – provide step-by-step instructions so we can reproduce the issue (*We can't fix what we can't reproduce*). +* Attach screenshots if possible. +* Attach your [VersionInfo](http://wiki.miranda-ng.org/index.php?title=Version_information). +* Attach a [crash report](http://wiki.miranda-ng.org/index.php?title=Crash_reports) if you are experiencing crashes (It includes VersionInfo as well). +* Attach a [network log](http://wiki.miranda-ng.org/index.php?title=Network_log) captured if you are experiencing connectivity issues. +* If Miranda freezes, hangs up or consumes CPU, attach [information obtained by Process Explorer tool](http://wiki.miranda-ng.org/index.php?title=Using_Process_Explorer_as_the_debugging_tool). + +### How to attach files +* Attach files by dragging & dropping, selecting them, or pasting from the clipboard +* Press *Submit new issue*. + +## I know when it got broken +If you know things got broken in some version or at some particular time, then it's good because you can try different releases from different revisions and narrow down where exactly the problem started to happen. +* you can either compile the revisions yourself (that requires more knowledge and time) +* or ask someone in our [jabber conference](xmpp:miranda-ng-int@conference.jabber.ru?join) to help you identify potentially problematic revisions and then ask to compile those revisions for you. + +Then you can try to reproduce your problem on each of them and find out when exactly it got broken. With that info it's easy to reach out the developer who commited the broken commit and ask him to look at it. + +## After reporting an issue +* Monitor the issues you report. +* Provide feedback and additional information if requested. +* Don't argue about whether something is a bug or not. diff --git a/ISSUE_TEMPLATE.md b/ISSUE_TEMPLATE.md new file mode 100644 index 0000000000..6a93bcbafa --- /dev/null +++ b/ISSUE_TEMPLATE.md @@ -0,0 +1,12 @@ +### Expected behaviour +What did you expect? + +### Actual behaviour +What did you get instead? + +### Steps to reproduce that behaviour + * provide step-by-step instructions so we can reproduce the issue (We can't fix what we can't reproduce). + * Attach your VersionInfo. + * Attach a crash report if you are experiencing crashes (It includes VersionInfo as well). + * Attach a network log captured if you are experiencing connectivity issues. + * If Miranda freezes, hangs up or consumes CPU, attach information obtained by Process Explorer tool. -- cgit v1.2.3