Difference between revisions of "Where to Report Bugs"

From PINE64
Jump to navigation Jump to search
(→‎Overview: wording fixed)
Line 25: Line 25:
* Crust: https://github.com/crust-firmware/crust/issues?q=is%3Aissue
* Crust: https://github.com/crust-firmware/crust/issues?q=is%3Aissue
* Pinephone Modem SDK: https://github.com/Biktorgj/pinephone_modem_sdk/issues?q=is%3Aissue
* Pinephone Modem SDK: https://github.com/Biktorgj/pinephone_modem_sdk/issues?q=is%3Aissue
===User Interfaces===
* Plasma Mobile: https://invent.kde.org/plasma/plasma-mobile/-/issues
** Plasma Mobile applications: https://invent.kde.org/groups/plasma-mobile/-/issues
* Phosh: https://gitlab.gnome.org/World/Phosh/phosh/-/issues?scope=all&state=all
** Phosh projects: https://gitlab.gnome.org/World/Phosh


===Operating Systems===
===Operating Systems===
Line 51: Line 57:
* Swmo: https://todo.sr.ht/~mil/sxmo-tickets
* Swmo: https://todo.sr.ht/~mil/sxmo-tickets
* Ubuntu Touch: https://gitlab.com/ubports/community-ports/pinephone/-/issues?sort=created_date&state=all
* Ubuntu Touch: https://gitlab.com/ubports/community-ports/pinephone/-/issues?sort=created_date&state=all
===User Interfaces===
* Plasma Mobile: https://invent.kde.org/plasma/plasma-mobile/-/issues
** Plasma Mobile applications: https://invent.kde.org/groups/plasma-mobile/-/issues
* Phosh: https://gitlab.gnome.org/World/Phosh/phosh/-/issues?scope=all&state=all
** Phosh projects: https://gitlab.gnome.org/World/Phosh


===Hardware Issues===
===Hardware Issues===
TBD
TBD

Revision as of 13:34, 21 March 2022

Reporting bugs is a great way to contribute and to help bringing order at managing and solving issues.

Overview

Issues should only be reported in the correct bug trackers, not in the community chats. The reasons for this can be found in the following information box.

Why shouldn't I report issues in the community chats?
  • Development takes place in platforms such as GitLab, sourcehut and Github with a certain procedure (issue reports, commits, linking to the issues and marking them solved). Reports in the chat are not designated to be a part of that process (until an advanced artificial intelligence some day can evaluate them and automatically ask the user for more details).
  • Talking about an issue and workarounds carries the discussion further away from the actual development and leads to discussions in forums and chatrooms.
  • Shared and accepted workarounds don't find their way back into the code and may be accepted as "tolerable evil".
  • Bug reports in chats are getting scrolled out, repeated and as a result repetitive for everyone involved and leads to future users with the same or similar issues not getting pointed to the correct places anymore.
  • It is expected that people mentioning issues will also report them properly. Conversations about bugs without reporting them makes users and developers think it is reported already and as a result the issue will never be reported (and therefore not fixed).
  • Unlike many commercial and/or proprietary projects, developers are part of the open community and there is therefore no need of having to solve issues via side channels.

PinePhone and PinePhone Pro

Issues with the PinePhone and the PinePhone Pro can be reported on the following bug trackers (selection).

Bootloaders and Firmwares

User Interfaces

Operating Systems

Hardware Issues

TBD