Difference between revisions of "Bug Report guidelines"

From WebOS-Ports
Jump to navigation Jump to search
(Update links)
 
(2 intermediate revisions by one other user not shown)
Line 11: Line 11:
 
<!--*    Requesting new software: you should follow the guidelines at [[NewPackages]]-->
 
<!--*    Requesting new software: you should follow the guidelines at [[NewPackages]]-->
  
*    Requesting support: there are a multitude of ways you can get help using webOS ports, such as the [http://webchat.freenode.net/?channels=webos-ports #webos-ports] channel on the Freenode IRC server.
+
*    Requesting support: there are a multitude of ways you can get help using webOS ports, such as the [https://web.libera.chat/#webos-ports #webos-ports] channel on the Libera IRC server.
  
 
*    Discussing features and existing policy: this belongs to the IRC channel.
 
*    Discussing features and existing policy: this belongs to the IRC channel.
Line 19: Line 19:
 
==Reporting the bug==
 
==Reporting the bug==
  
Please create an account on issues.webos-ports.org, ask a team member to activate your account (Usually [[Contributors|Herrie or ka6sox]] are around (on IRC is the best way to catch them but email/Twitter would work too) to do this) and login. Next, browse to http://issues.webos-ports.org/projects and decide where the bug belongs. Once you open a bug report please make sure it contains the following information
+
Browse to https://github.com/webOS-ports/luneos-testing/issues and decide where the bug belongs. Once you open a bug report please make sure it contains the following information
  
* Name of the rootfs image
+
* Name of the device
 
* Steps to reproduce
 
* Steps to reproduce
* Direct link to build on build.webos-ports.org with this issue
+
* Direct link to build  
* Download diag.sh from https://github.com/webOS-ports/webos-ports-sdk/scripts, and include the .tgz file it produces
+
 
 +
 
 +
If it will be useful, please also provide a [[To capture a screen shot on LuneOS|screen shot]].
  
 
==Attributions==
 
==Attributions==
  
 
Based on the [https://help.ubuntu.com/community/ReportingBugs Ubuntu Bug Reporting Guideline]
 
Based on the [https://help.ubuntu.com/community/ReportingBugs Ubuntu Bug Reporting Guideline]

Latest revision as of 09:07, 13 February 2024

Thank you for reading this article. This will guide you on how best to present your bug report so that it gets addressed as soon as possible. Here are a few guiding principles that lead to success in getting bugs fixed:

Before filing any hardware related reports on issues.webos-ports.org, please update your build to the latest build from build.webos-ports.org to ensure that your bug report has not already been resolved by the developers.

Please do not quote Wikipedia and other non-primary resource information as fact on issues.

Is it a bug?

Determine if the bug is really a bug

You should not file a bug if you are:

  • Requesting support: there are a multitude of ways you can get help using webOS ports, such as the #webos-ports channel on the Libera IRC server.
  • Discussing features and existing policy: this belongs to the IRC channel.
  • Filing a bug against a program not provided by an webOS-Ports package: You should file a bug in that program's bug tracking interface. Instructions are generally available on the program's web site.

Reporting the bug

Browse to https://github.com/webOS-ports/luneos-testing/issues and decide where the bug belongs. Once you open a bug report please make sure it contains the following information

  • Name of the device
  • Steps to reproduce
  • Direct link to build


If it will be useful, please also provide a screen shot.

Attributions

Based on the Ubuntu Bug Reporting Guideline