Improving stuff

Author: antonpirker

README.md

@@ -1,17 +1,35 @@
 <a href="https://sentry.io/?utm_source=github&utm_medium=logo" target="_blank">
   <img src="https://sentry-brand.storage.googleapis.com/github-banners/github-sdk-python.png" alt="Sentry for Python">
 </a>
-_Bad software is everywhere, and we're tired of it. Sentry is on a mission to help developers write better software faster, so we can get back to enjoying technology. If you want to join us, [<kbd>**check out our open positions**</kbd>](https://sentry.io/careers/)_.
 
-# Official Sentry SDK for Python
+<div align="center">
 
-[![Build Status](https://github.com/getsentry/sentry-python/actions/workflows/ci.yml/badge.svg)](https://github.com/getsentry/sentry-python/actions/workflows/ci.yml)
+<br/>
+
+[![Discord](https://img.shields.io/discord/621778831602221064?logo=discord&labelColor=%20%235462eb&logoColor=%20%23f5f5f5&color=%20%235462eb)](https://discord.gg/wdNEHETs87)
+[![Twitter Follow](https://img.shields.io/twitter/follow/getsentry?label=@getsentry&style=social)](https://twitter.com/intent/follow?screen_name=getsentry)
 [![PyPi page link -- version](https://img.shields.io/pypi/v/sentry-sdk.svg)](https://pypi.python.org/pypi/sentry-sdk)
-[![Discord](https://img.shields.io/discord/621778831602221064)](https://discord.gg/cWnMQeA)
+<img src="https://img.shields.io/badge/python-3.7 | 3.8 | 3.9 | 3.10 | 3.11 | 3.12 | 3.13-blue.svg" alt="python">
+[![Build Status](https://github.com/getsentry/sentry-python/actions/workflows/ci.yml/badge.svg)](https://github.com/getsentry/sentry-python/actions/workflows/ci.yml)
+
+_Bad software is everywhere, and we're tired of it. Sentry is on a mission to help developers write better software faster, so we can get back to enjoying technology. If you want to join us
+[<kbd>**Check out our open positions**</kbd>](https://sentry.io/careers/)_.
+
+<br/>
+
+</div>
+
+
+# Official Sentry SDK for Python
+
+Welcome to the official Python SDK for **[Sentry](http://sentry.io/)**.
+
+<a name="getting-started"></a>
+## 📦 Getting Started
 
-Welcome to the official Python SDK for **[Sentry](http://sentry.io/)**!
+### Prerequisites
 
-## 🚀 Getting Started
+You need a Sentry [account](https://sentry.io/signup/) and [project](https://docs.sentry.io/product/projects/).
 
 ### Installation
 
@@ -32,7 +50,7 @@ sentry_sdk.init(
     "https://[email protected]/1",  # Your DSN here
 
     # Set traces_sample_rate to 1.0 to capture 100%
-    # of transactions for performance monitoring.
+    # of traces for performance monitoring.
     traces_sample_rate=1.0,
 )
 ```
@@ -44,35 +62,26 @@ With this configuration, Sentry will monitor for exceptions and performance issu
 To generate some events that will show up in Sentry, you can log messages or capture errors:
 
 ```python
-from sentry_sdk import capture_message
-capture_message("Hello Sentry!")  # You'll see this in your Sentry dashboard.
+import sentry_sdk
+sentry_sdk.init(...)  # same as above
+
+sentry_sdk.capture_message("Hello Sentry!")  # You'll see this in your Sentry dashboard.
 
 raise ValueError("Oops, something went wrong!")  # This will create an error event in Sentry.
 ```
 
-#### Explore the Docs
+<a name="documentation"></a>
+## 📚 Documentation
 
-For more details on advanced usage, integrations, and customization, check out the full documentation:
-
-- [Official SDK Docs](https://docs.sentry.io/platforms/python/)
-- [API Reference](https://getsentry.github.io/sentry-python/)
+For more details on advanced usage, integrations, and customization, check out the full documentation on [https://docs.sentry.io](https://docs.sentry.io/).
 
+<a name="integrations"></a>
 ## 🧩 Integrations
 
-Sentry integrates with many popular Python libraries and frameworks, including:
-
-- [Django](https://docs.sentry.io/platforms/python/integrations/django/)
-- [Flask](https://docs.sentry.io/platforms/python/integrations/flask/)
-- [FastAPI](https://docs.sentry.io/platforms/python/integrations/fastapi/)
-- [Celery](https://docs.sentry.io/platforms/python/integrations/celery/)
-- [AWS Lambda](https://docs.sentry.io/platforms/python/integrations/aws-lambda/)
-
-Want more? [Check out the full list of integrations](https://docs.sentry.io/platforms/python/integrations/).
-
-### Rolling Your Own Integration?
+Sentry integrates with a ton of popular Python libraries and frameworks, including [FastAPI](https://docs.sentry.io/platforms/python/integrations/fastapi/), [Django](https://docs.sentry.io/platforms/python/integrations/django/), [Celery](https://docs.sentry.io/platforms/python/integrations/celery/), [OpenAI](https://docs.sentry.io/platforms/python/integrations/openai/) and many, many more.  Check out the [full list of integrations](https://docs.sentry.io/platforms/python/integrations/) to get the full picture.
 
-If you want to create a new integration or improve an existing one, we'd welcome your contributions! Please read our [contributing guide](https://github.com/getsentry/sentry-python/blob/master/CONTRIBUTING.md) before starting.
 
+<a name="migrating"></a>
 ## 🚧 Migrating Between Versions?
 
 ### From `1.x` to `2.x`
@@ -83,29 +92,34 @@ If you're using the older `1.x` version of the SDK, now's the time to upgrade to
 
 Using the legacy `raven-python` client? It's now in maintenance mode, and we recommend migrating to the new SDK for an improved experience. Get all the details in our [migration guide](https://docs.sentry.io/platforms/python/migration/raven-to-sentry-sdk/).
 
+<a name="contributing"></a>
 ## 🙌 Want to Contribute?
 
-We'd love your help in improving the Sentry SDK! Whether it's fixing bugs, adding features, or enhancing documentation, every contribution is valuable.
+We'd love your help in improving the Sentry SDK! Whether it's fixing bugs, adding features, writing new integrations, or enhancing documentation, every contribution is valuable.
 
-For details on how to contribute, please check out [CONTRIBUTING.md](CONTRIBUTING.md) and explore the [open issues](https://github.com/getsentry/sentry-python/issues).
+For details on how to contribute, please read our [contribution guide](CONTRIBUTING.md) and explore the [open issues](https://github.com/getsentry/sentry-python/issues).
 
+<a name="help"></a>
 ## 🛟 Need Help?
 
 If you encounter issues or need help setting up or configuring the SDK, don't hesitate to reach out to the [Sentry Community on Discord](https://discord.com/invite/Ww9hbqr). There is a ton of great people there ready to help!
 
-## 📚 Resources
+<a name="resources"></a>
+## 🔗 Resources
 
-Here are additional resources to help you make the most of Sentry:
+Here are all resources to help you make the most of Sentry:
 
-- [![Documentation](https://img.shields.io/badge/documentation-sentry.io-green.svg)](https://docs.sentry.io/quickstart/) – Official documentation to get started.
-- [![Discord](https://img.shields.io/discord/621778831602221064)](https://discord.gg/Ww9hbqr) – Join our Discord community.
-- [![Twitter Follow](https://img.shields.io/twitter/follow/getsentry?label=getsentry&style=social)](https://twitter.com/intent/follow?screen_name=getsentry) – Follow us on X (Twitter) for updates.
-- [![Stack Overflow](https://img.shields.io/badge/stack%20overflow-sentry-green.svg)](http://stackoverflow.com/questions/tagged/sentry) – Questions and answers related to Sentry.
+- [Documentation](https://docs.sentry.io/platforms/python/) - Official documentation to get started.
+- [Discord](https://img.shields.io/discord/621778831602221064) - Join our Discord community.
+- [X/Twitter](https://twitter.com/intent/follow?screen_name=getsentry) -  Follow us on X (Twitter) for updates.
+- [Stack Overflow](https://stackoverflow.com/questions/tagged/sentry) - Questions and answers related to Sentry.
 
+<a name="license"></a>
 ## 📃 License
 
 The SDK is open-source and available under the MIT license. Check out the [LICENSE](LICENSE) file for more information.
 
+<a name="contributors"></a>
 ## 😘 Contributors
 
 Thanks to everyone who has helped improve the SDK!