jiayr99 / pe

0 stars 0 forks source link

Better definition for insurance agents in glossary in DG #11

Open jiayr99 opened 1 week ago

jiayr99 commented 1 week ago

image.png

The definition for insurance agent could be better, for example a description of their jobs could be added or could includethe actions that an insurance agent would take.

soc-se-bot commented 5 days ago

Team's Response

Thanks for bringing up the issue. While we accept it as a bug, we feel that an insurance agent is quite well defined in general and its rare for developers to not know what this means so we did set the severity as low.

Items for the Tester to Verify

:question: Issue severity

Team chose [severity.Low] Originally [severity.Medium]

Reason for disagreement: Thank you for your response. However, I respectfully maintain that the severity should be considered medium.

While the term "insurance agent" might be generally understood, definitions in a professional context need to be precise to prevent misinterpretation. The roles and responsibilities of insurance agents are not universally understood, especially in a global context where their duties can vary significantly across regions. This is particularly relevant since the app does not impose restrictions on phone numbers, suggesting its intended use spans multiple countries.

A clear and detailed definition would not only ensure consistency across diverse user bases but also enhance the reader's understanding of how the app aligns with the agent's responsibilities. This clarity is essential for readers to fully grasp the features and functionalities that have been implemented, thereby improving the app's usability and accessibility.

For these reasons, I believe the issue impacts the application's effectiveness enough to warrant a medium severity classification.