summaryrefslogtreecommitdiff
path: root/docs/testing
diff options
context:
space:
mode:
authorKali Kaneko (leap communications) <kali@leap.se>2016-10-03 20:40:03 -0400
committerKali Kaneko (leap communications) <kali@leap.se>2016-10-03 21:48:27 -0400
commit5519d02f609a87b0ca47a8e82c116811005b6277 (patch)
treeeea053d2ff8f99a80b2595119cfae829781135a1 /docs/testing
parent8cdbf714b905246363221089bbf8579e7c8e020c (diff)
[docs] revamp bitmask dev docs
Diffstat (limited to 'docs/testing')
-rw-r--r--docs/testing/index.rst54
1 files changed, 54 insertions, 0 deletions
diff --git a/docs/testing/index.rst b/docs/testing/index.rst
new file mode 100644
index 00000000..1adedbad
--- /dev/null
+++ b/docs/testing/index.rst
@@ -0,0 +1,54 @@
+:LastChangedDate: $LastChangedDate$
+:LastChangedRevision: $LastChangedRevision$
+:LastChangedBy: $LastChangedBy$
+
+.. _qa:
+
+Testing and Reporting
+================================
+
+Reporting bugs
+--------------------------------
+
+* Bug reports go into our `Issue Tracker`_.
+* `Here`_ is some very good read about what constitutes a `good bug report`_.
+* Have also a look at the :ref:`Known Issues <issues>` page.
+
+.. _`Issue Tracker`: https://leap.se/code
+.. _`Here`: http://www.chiark.greenend.org.uk/~sgtatham/bugs.html
+.. _`good bug report`: http://www.chiark.greenend.org.uk/~sgtatham/bugs.html
+
+Tips for QA
+--------------------------------
+
+From time to time, we'll ask the community for help testing a new alpha release
+or a release candidate. Normally, we'll offer a link for the download of a
+self-contained bundle just for internal testing purposes. These will be updated
+quite often, as soon as there are fixes available to fix the release-critical
+bugs.
+
+If you want to give a hand in this process, please follow the following tips:
+
+* Focus all your efforts, if possible, on whatever is *the* golden distro at
+ the time of the release. This currently is: Ubuntu 16.04.x LTS, 64bits, with
+ Unity as the default desktop environment.
+ It's very important to have a reference environment as bug-free as possible,
+ before trying to solve issues that are present in other distributions or window
+ managers.
+* Identify all issues that need help in the QA phase. You can do that going to
+ the bug tracker, and filtering all the issues for a given release that are in
+ the QA state.
+* If the issue is solved in your tests for this alpha release, please add a
+ comment to the issue stating the results of your tests, and the platform and
+ desktop environment in which your tests took place. But please do not change
+ the QA status on the issue. We generally leave this role to the author of the
+ original issue, or to the person playing the role of the release QA master.
+* Always test with a newly created account (specially relevant when testing
+ email candidates)
+* Always test with the reference Mail User Agent (currently, Thunderbird, in
+ whatever version is present in the reference distribution).
+* Remove also any thunderbird configuration, start a freshly configured account.
+* If you find a new bug, please make sure that it hasn't already been reported
+ in the issue tracker. If you are absolutely certain that you have found a new
+ bug, please attach a log of a new bitmask session, which should contain
+ *only* the behaviour needed to reproduce the bug you are reporting.