Report Bugs or Errors#
Note
We are sorry to find you on this page! But we are happy to help you with your problem. Please follow the steps below to report a bug or error.
Errors in the Documentation#
The underlying content of the Brightway documentation website is hosted in the GitHub repository brightway-documentation. You can therefore:
🥈 Report the Error#
Prerequisites
In order to report an error in the documentation, please open an new issue in this repository, describing the error and where you found it. A member of the Brightway developer community will then take care of the issue. Please note that all developments are undertaken on a voluntary basis, so it may take some time for your issue to be resolved.
🥇 Fix the Error Yourself#
Prerequisites
Basic knowledge of the GitHub contribution workflow (fork, branch, PR)
A fork of the
brightway-examplesrepositoryBasic knowledge of Markdown
In order to fix an error in the documentation, you can make an edit of the underlying content yourself:
Use the
✏️ Edit on GitHubbutton on the top right of the page to open the corresponding file in the GitHub repository. This shows you which file you need to edit.Edit the file in your fork of the repository. Finally, create a pull request.
As soon as a member of the Brightway developer community has merged your pull request, the changes will be visible on the Brightway documentation website.
Bugs in the Brightway Code#
First you must identify which package contains the bug you have found. You can do so by examining the Python Traceback, which is the error message that is displayed when the bug occurs. The traceback will contain the name of the package that contains the bug. This could be:
Traceback (most recent call last):
File "<string>", line 1, in <module>
AttributeError: module 'bw2calc' has no attribute 'ComparativeMonteCarlo'
All Brightway packages are hosted in the GitHub organization brightway-lca. You can therefore:
🥈 Report the Bug#
Prerequisites
Basic knowledge of the Python Error Traceback
In order to report a bug in a Brightway package, please open a new issue in the corresponding repository:
(all other Brightway packages can be found on the repository overview page of the brightway-lca GitHub organization)
Your issue should include:
the complete Python Traceback
a description of the bug
information your operating system and Python version
the steps required to reproduce the bug
A member of the Brightway developer community will then take care of the issue. Please note that all developments are undertaken on a voluntary basis, so it may take some time for your issue to be resolved.
🥇 Fix the Bug Yourself#
Prerequisites
Basic knowledge of the GitHub contribution workflow (fork, branch, PR)
A fork of the relevant repository
Follow the usual GitHub contribution workflow.