Difference between revisions of "Where to Report Bugs"

From PINE64
Jump to navigation Jump to search
(Added examples)
 
(9 intermediate revisions by one other user not shown)
Line 1: Line 1:
Reporting bugs is a great way to contribute and to help bringing order at managing and solving issues.
== Overview ==
== Overview ==


{{hint|Why shouldn't I report issues in the community chats?
Issues should '''only''' be reported in the correct '''bug trackers''', not in the community chats. The following list is a selection of common bug trackers.
 
Reporting issues in the community chats is actually a bad idea for multiple reasons:
 
* 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). Chat reports are not a part of that procedure.
* Talking about an issue and workarounds carries the discussion further away from the actual development and leads to discussions in forums and chatrooms, in contrast to bug trackers.
* 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 get annoying for everyone involved and leads to future users with the same or similar issues not getting helped anymore.
* It is expected that people mentioning issues also report them. Chatting about them without reporting them makes everyone think it is reported already and then the issue will never be reported (and therefore not fixed).
* The transition from community to developer are fluent, we don't have situations of "they above" versus the "we the users, who have to help themselves" here, like other commercial projects have. Don't even think about trying to bring such mindsets into the community.
}}


== PinePhone and PinePhone Pro ==
== PinePhone and PinePhone Pro ==


===Bootloaders and Firmwares===
Issues with the PinePhone and the PinePhone Pro can be reported on the following bug trackers (selection).
* U-Boot:
* Tow-Boot: https://github.com/Tow-Boot/Tow-Boot/issues?q=
* Levinboot: https://gitlab.com/DeltaGem/levinboot/-/issues?sort=created_date&state=all
* 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


===Operating Systems===
===Operating Systems and Distributions===
* Arch Linux ARM (DanctNIX): https://github.com/dreemurrs-embedded/Pine64-Arch/issues?q=is%3Aissue
* Arch Linux ARM (DanctNIX): https://github.com/dreemurrs-embedded/Pine64-Arch/issues?q=is%3Aissue
* ExpidusOS: https://github.com/orgs/ExpidusOS/repositories
* ExpidusOS: https://github.com/orgs/ExpidusOS/repositories
Line 53: Line 40:
* Phosh: https://gitlab.gnome.org/World/Phosh/phosh/-/issues?scope=all&state=all
* Phosh: https://gitlab.gnome.org/World/Phosh/phosh/-/issues?scope=all&state=all
** Phosh projects: https://gitlab.gnome.org/World/Phosh
** Phosh projects: https://gitlab.gnome.org/World/Phosh
===Bootloaders and Firmwares===
* U-Boot: TBD
* Tow-Boot: https://github.com/Tow-Boot/Tow-Boot/issues?q=
* Levinboot: https://gitlab.com/DeltaGem/levinboot/-/issues?sort=created_date&state=all
* 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


===Hardware Issues===
===Hardware Issues===
The page [[PinePhone Hardware Issues]] can be used to track known problems with the hardware (and how to fix them). If you're not exactly sure how to describe the issue, try the discussion tab for that page, or other community resources.
=== Accessories ===
TBD
TBD
== PineTime ==
* InfiniTime: https://github.com/InfiniTimeOrg/InfiniTime/issues?q=is%3Aissue
== PineTab ==
* Arch Linux ARM: https://github.com/dreemurrs-embedded/Pine64-Arch/issues?q=is%3Aissue+label%3A%22device%3A+pinetab%22
* Manjaro ARM: https://gitlab.manjaro.org/manjaro-arm/issues
* Mobian: https://gitlab.com/mobian1/issues
* postmarketOS: https://gitlab.com/postmarketOS/pmaports/-/issues?sort=created_date&state=opened&label_name%5B%5D=device-pine64-pinetab
* Ubuntu Touch: https://gitlab.com/ubports/community-ports/pinephone/-/issues?sort=created_date&state=all

Latest revision as of 18:26, 2 July 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 following list is a selection of common bug trackers.

PinePhone and PinePhone Pro

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

Operating Systems and Distributions

User Interfaces

Bootloaders and Firmwares

Hardware Issues

The page PinePhone Hardware Issues can be used to track known problems with the hardware (and how to fix them). If you're not exactly sure how to describe the issue, try the discussion tab for that page, or other community resources.

Accessories

TBD

PineTime

PineTab