1 5. Issues and Reporting Problems
sashaastiadi edited this page 2024-10-30 13:50:26 +00:00

Issues and Reporting Problems: Instructions for Reporting Bugs, Technical Issues, or Content Errors

If you encounter any bugs, technical issues, or content errors on the websites within the ThreeFold ecosystem, please follow these instructions to report the problem effectively.

Steps to Report an Issue

  1. Create a New Issue on the circle_web_presence repository and choose 'general issue'.

  2. Repository or Website:
    Provide the repository or website related to the issue.

  3. Issue Description:
    Provide a brief description of the issue, detailing what the problem is and how it affects the user experience.

  4. Additional Information:
    Include any other relevant information that may help the development team understand the issue, such as browser type, operating system, or error messages.

  5. Steps to Resolve (if applicable):
    If you have any suggestions for how to resolve the issue, please outline them here. For example:

    1. Step 1 to reproduce the issue
    2. Step 2 to reproduce the issue
    3. Step 3 to reproduce the issue
  6. Expected Outcome:
    Describe what you expected to happen instead of the issue you encountered.

  7. Specify the Change to be Made:
    If applicable, indicate what changes should be made, such as modifications to text, images, or design elements.

  8. Click 'Create Issue':
    Once you have filled in all the necessary information, click 'Create Issue' to submit your report.

  9. Track Your Issue:
    You can track the progress of your issue on the Web Presence Project.

By following these guidelines, you help ensure that issues are reported clearly and can be resolved efficiently, improving the overall quality and user experience of our web properties.


Example Issue Report

"Contact Us" form on the OurVerse website is not submitting properly

  1. Repository or Website:
    Website: OurVerse
    Repository: Ourverse_tf

  2. Issue Description:
    The "Contact Us" form on the OurVerse website is not submitting properly. When users fill out the form and click "Submit," they receive an error message stating "Form submission failed."

  3. Additional Information:

    • Browser: Chrome Version 115.0.5790.98
    • Operating System: Windows 10
    • Error Message: "Form submission failed"
  4. Steps to Resolve (if applicable):

    1. Navigate to the OurVerse website.
    2. Go to the "Contact Us" page.
    3. Fill out the form with valid information.
    4. Click "Submit" and observe the error message.
  5. Expected Outcome:
    The form should submit successfully and display a confirmation message.

  6. Specify the Change to be Made:
    Investigate the backend handling of form submissions and ensure that the validation process is functioning correctly.