docs: rephrase report-bugs page

faker-js · xDivisionByZerox · Jun 29, 2025 · Dec 3, 2023 · Apr 27, 2024 · Apr 27, 2024
commit 23a23650ddadf9e5c9bd54e72ad9a1ff7a97844c
@@ -1,12 +1,16 @@
 # Report Bugs
 
-If you think you’ve found a bug in Faker, please create a new issue using the [Bug Report Template](https://github.com/faker-js/faker/issues/new?labels=s%3A+pending+triage%2Cc%3A+bug&template=bug_report.yml).
-This allows you to provide steps to reproduce, and allows other users to confirm this is actually a bug.
+Thank you for taking the time to help improve Faker!
+Your contributions are invaluable in keeping the project reliable and useful for everyone.
+We kindly ask that you follow the guidelines below when reporting a bug.
+Providing clear and detailed information allows us to verify problems quickly and work toward effective solutions.
 
-Please include as much detail as possible to help us properly address your issue.
-By including comprehensive information upfront, you assist us in efficiently addressing your concerns.
-This approach minimizes the need for follow-up questions and allows us to focus on resolving the issue promptly.
+If you believe you've discovered a bug in Faker, please submit a new issue using the [Bug Report Template](https://github.com/faker-js/faker/issues/new?labels=s%3A+pending+triage%2Cc%3A+bug&template=bug_report.yml).
+This will help you provide clear reproduction steps and allow other users to verify that the issue is indeed a bug.
+
+To facilitate a swift resolution, please include as much relevant detail as possible.
+Providing comprehensive information upfront reduces the need for follow-up questions, enabling us to focus on resolving the issue efficiently.
 
 ::: info Note
-If you just have a question that won’t necessarily result in a change to Faker, such as asking how something works or how to contribute, please open a [discussion](https://github.com/faker-js/faker/discussions) or stop by our [Discord server](https://chat.fakerjs.dev) instead of filing an issue.
+If you have a general question that doesn't require a change to Faker - such as understanding how something works or learning how to contribute - please start a [discussion](https://github.com/faker-js/faker/discussions) or join our [Discord server](https://chat.fakerjs.dev) instead of opening an issue.
 :::