1
0
Fork 0
mirror of https://github.com/syncthing/syncthing-android.git synced 2024-11-25 22:01:16 +00:00
syncthing-android/CONTRIBUTING.md

1.8 KiB

Reporting An Issue

Please search for existing issues before opening a new one.

Where To Report

Issues might be related either to syncthing, syncthing-android or both. The general rule of thumb is this: If the issue has to do with synchronization, discovery, the web interface, or can be reproduced on a desktop, it should be posted at syncthing.

If the issue is related to the Android UI, background service, or can't be reproduced on a desktop running the same syncthing version, it should be posted here.

For general usage help or questions, you should post to discourse.

Bug Reports

A bug report should include the following information:

Description of the problem.

Steps to reproduce:

  1. This is the first step
  2. This is the second step
  3. Further steps, etc.

Observed behaviour and expected behaviour.

syncthing-android version: x.x.x

Device name and Android version:

versions of involved syncthing nodes: vx.x.x, ...

logcat: link to file (over the entire procedure, limited to the package com.nutomic.syncthingandroid if you can, How to Logcat Android Studio Logging Guide).

config.xml: link to file (if it might be related, located in /data/data/com.nutomic.syncthingandroid, requires root)

screenshots: link to file (only for UI problems)

Pull Requests

Always welcome.

Code should follow the Android Code Style Guidelines, with the exception that we use tabs, not spaces for indentation.

Lint warnings should be fixed. If that's not possible, they should be ignored as specifically as possible.