Understanding a Bug

Think of a software bug as a situation where someone reports that a lamp in their house isn't working. If they simply say, "My lamp doesn’t work," without providing any additional details, it becomes challenging to help them.

Just like a technician would need to know the address, which room the lamp is in, and perhaps the type of lamp or the last time it worked, software developers need specific information to diagnose and fix a bug. The quicker and more accurately a user can describe where and how the problem occurs, the faster the developers can find the solution and 'fix the light', so to speak.

Essential Information for Reporting a Bug

To help our support team swiftly address your issue, please provide as much detailed information as possible. Here's what you should include:

• User Name: Your identifier in the system (email or user name).

• Time of Occurrence: When did you encounter the bug? (date and time)

• Environment: Specify whether it happened in development (dev), pre-production (pre-prod), or production.

• User Agent: This is a technical term for the browser or application you were using when you encountered the bug. You can find your user agent by searching "
  {height="" width=""}" in your web browser.

• Screenshots or Screen Recordings: Visual evidence of the bug. This can be particularly helpful in understanding exactly what went wrong.

• Console Errors: If you're comfortable, check the console in your web browser for any error messages (Right-click on the webpage, select "Inspect" or "Inspect Element", and then click on the "Console" tab). Screenshot any errors you see.
  

• Brief Description of the Issue: What problem did you encounter? Describe it in simple terms.

• Steps to Reproduce: Provide a step-by-step guide on how to encounter the bug again. For example:

  • Step 1: Log in to your account.
  • Step 2: Click on the 'Reports' section.
  • Step 3: Select the date range 'Last Month'.

• Expected Behavior: Describe what you expected to happen that did not because of the bug.

How to Report a Bug

We encourage you to use the method most convenient for you to submit a bug report. You have several channels at your disposal:

• Email us directly at support@lighton.ai
• Use the Slack channel "user support"
• Utilize the "flag a bug" feature directly within the chat interface

Remember, the more detailed your bug report, the faster we can resolve the issue. Our team is committed to providing prompt and efficient support to ensure a smooth experience with our services.