Available translations

How to Report an Issue

foundations.png
Summary: Reporting an issue is a process that entails doing some basic research, carefully describing how to reproduce the issue, and gathering crucial information.
Before you consider reporting an issue, make sure you do everything within your reach to investigate the problem. In most cases, you will find that there is no issue at all and that you were making a mistake, skipping a step in the process, or not fulfilling a requirement.
1. Search for Similar Issues
Go to the Issues page in the Superalgos repository and use the search box to find issues that may be similar to yours.
  • Search for open and closed issues (remove the is open tag).
  • Try different keywords you would use to describe the issue.
If you find an issue that is similar to yours, read the whole thread. You may find information conducive to solving the issue, proposed workarounds, or reports on the status of the solution to the issue.
If you believe you have information relevant to the issue that has not yet been offered by other users, then go ahead and reply to the issue with everything you know about your case.
If there are no issues similar to yours, or your issue happens in a different context not addressed in the issues you’ve found, then go on with the next few steps.
2. Are you Ready to Report an Issue?
Please, make an honest assessment of the following questions:
  • Have you tested your issue with today’s version of the software?
  • Have you verified that none of the troubleshooting pages in the documentation addresses and solves your issue?
  • Have you captured and saved the associated errors in the browser console or the Log-Files folder?
  • In case your issue is related to the frontend… are you using Chrome or Safari to test the issue?
If you answer no to any of the above, then you are not ready to open an issue. If you may confidently answer yes to all questions, then please proceed.
3. Consider the Following
If the issue may be reproduced on one of the official workspaces, then report the issue as such. Issues occurring on custom workspaces have a lower priority.
Issues that may not be reproduced have lower priority than those that may be reproduced.
4. Open a New Issue
Click the New Issue button and select Get Started on the Bug report item. The following form will open:
Carefully complete the form following the below guidelines:
Title
Do your best to describe the issue in a single, short sentence. Take your time. A good practice is describing what happens and in which context. For example: “WHB backtest stops short of finalDatetime”.
Context
Complete and adjust the contents leaving the information that fits your case and deleting the information that doesn’t.
  • Operating System: Windows / MacOs / Linux / Other (include the version on either case)
  • Software version: today’s master branch / today’s develop branch
  • Reproducible: the issue may / may not be reproduced.
Explain Your Issue
  • Explain what the problem seems to be.
  • Clearly explain what you wish to accomplish.
  • Explain, step by step, what you’ve done to achieve the goal. The Team will follow these steps to reproduce the issue, so be precise.
  • Explain what is the result you expect from your actions.
  • Explain what happens instead of the expected results.
  • Explain what errors you have found on-screen, on the browser console application, or in the Log-Files folder.
Reproduce the Issue on Video
The most important aspect of investigating an issue is being able to reproduce it. Capturing a video showing the steps that lead to the issue would be of great help.
If the issue happens within the browser, you may use the systems’ video capture feature:
  • Hit Ctrl + F8 to capture a static PNG image.
  • Hit Ctrl + F9 to start capturing a GIF video, and hit the same key combination again to end the capture. Once the capture ends, it takes some time to process the capture and generate the final file.
  • Hit Ctrl + F10 to start capturing a WEBM video, and hit the same key combination again to end the capture. WEBM videos are processed instantly.
In all three cases, the browser downloads the resulting file and makes it available in the downloads folder.
In case the issue does not happen at the browser, for example, if it happens at the console, LICEcap is a lightweight, simple system that can help you capture GIF videos outside of Superalgos.
Attach Relevant Log Files
If you have on-screen errors or errors at the browser console, screen captures are fine.
If you have errors in the backend, attach the logs you have collected while following the troubleshooting guide.
Custom Workspace?
If the issue happens under specific conditions on a custom workspace, attach a share of the workspace. Do not attach backups as those may contain personal information such as API Keys.
5. Enable Github Notifications
Make sure you enable GitHub notifications when someone responds to the issue, as developers may want to ask for more information.
Previous
How to Troubleshoot an Issue
Next
How to Upgrade Your Existing Installation