Reporting Accessibility Issues on Ushahidi Platform Client (mzima version)

To ensure the continuous improvement of accessibility on the Ushahidi Platform Client (mzima version), it's essential for team members to report any accessibility issues they encounter during testing on GitHub.

Steps to Report Accessibility Issues

1. Navigate to the Ushahidi Platform GitHub Repository:

   • Visit the Ushahidi Platform GitHub repository (opens in a new tab).

2. Create a New Issue:

   • Click on the "Issues" tab in the repository.
   • Click on the "New issue" button.
   • Provide a descriptive title for the issue, clearly indicating the accessibility problem.

3. Describe the Issue:

   • In the issue description, provide a detailed explanation of the accessibility issue encountered.
   • Include relevant information such as the page URL, steps to reproduce the issue, and any assistive technologies used during testing.
   • Attach screenshots or screencasts demonstrating the problem, if applicable.

4. Mention Tools or Technologies Used:

   • Mention the assistive technologies or testing tools used to identify the accessibility issue.
   • This helps developers understand the context of the problem and address it effectively.

5. Submit the Issue:

   • Once the issue is thoroughly documented, click on the "Submit new issue" button to create the accessibility issue report.

6. Optional: Create a Pull Request (PR) for Fixes:

   • If team members are able to fix the accessibility issue themselves, they can create a pull request (PR) on the Ushahidi Platform Client (mzima version) GitHub repository (opens in a new tab).
   • Include the necessary code changes to address the accessibility issue in the PR.
   • Ensure that the PR description includes references to the related issue for better tracking and collaboration.