Add docs for bug reporting

Author: msfjarvis

docs/users/index.md

@@ -8,10 +8,12 @@ This is a work-in-progress effort to document things relevant to Password Store
 - [Importing from other password managers] : How to migrate to `pass`
 - [Invalid GPG key ID] : Why this error happens and how you can fix it
 - [Release channels] : Different ways to get prebuilt binaries of APS
+- [Reporting bugs] : Helpful information on how to craft good bug reports
 
 [Autofill]: autofill
 [build types]: build-types
 [release channels]: release-channels
 [invalid gpg key id]: invalid-gpg-key-id
 [importing from other password managers]: importing
 [background killing bugs]: background-killing-bugs
+[reporting bugs]: reporting-bugs

docs/users/reporting-bugs.md

@@ -0,0 +1,12 @@
+# Reporting bugs
+
+When submitting a bug report, it is often helpful to include a log. The following steps can be followed on any Linux machine to capture the logs for Password Store in a text file that you can attach to a GitHub issue.
+
+- Download the Android Platform Tools from [here](https://developer.android.com/studio/releases/platform-tools) and extract them into a directory
+- Enable developer options on your device and turn on USB debugging by following [these steps](https://developer.android.com/studio/debug/dev-options)
+- Enable debug logging for Password Store by going to Settings > Misc
+- Open a new terminal in the directory where you extracted the platform tools
+- Run `./adb shell am force-stop app.passwordstore` to close the app
+- Launch the app again and replicate the issue
+- Run `./adb logcat --pid=$(./adb shell pidof -s app.passwordstore) -d > log.txt` to capture the logs up till that point
+- Upload `log.txt` either to the GitHub issue or email it to `googleplay@passwordstore.app` with the issue link