Resolve test issue and update documentation

[timothywarner]

Related to #33

This pull request addresses the "Test issue" by introducing a new test suite, updating existing scripts with relevant comments, and adding documentation to the README.md file.

• Adds a new test suite: Implements src/test_issue.py to test functionalities related to the "Test issue", ensuring comprehensive coverage and correct implementation.
• Updates scripts with comments: Enhances src/alerts_to_sarif.py and src/data_analysis.py by adding comments that clarify their connection to the "Test issue", improving code readability and maintainability.
• Updates README.md: Adds a new section detailing the resolution process of the "Test issue", including steps taken and the impact on the repository, providing clarity and transparency to contributors and users.

---

For more details, open the Copilot Workspace session.