docs: @sentry_sdk.trace and static/class method decorator ordering

[szokeasaurusrex]

Pre-merge checklist

If you work at Sentry, you're able to merge your own PR without review, but please don't unless there's a good reason.

• Checked Vercel preview for correctness, including links
• PR was reviewed and approved by any necessary SMEs
• PR was reviewed and approved by a member of the Sentry docs team

Description of changes

This PR updates the Sentry Python SDK tracing docs to inform users that when tracing a static or class method using the @sentry_sdk.trace decorator, the decorator must be placed after the @staticmethod or @classmethod decorator.

Failing to adhere to this ordering will break the function (specifically when it is called on an instance rather than on the class), due to how static and class methods work in the Python language (see getsentry/sentry-python#2525). Unfortunately, because of how static and class methods work in Python it is probably impossible to change the @sentry_sdk.trace decorator to allow a flipped ordering, so alerting users in the documentation is likely the best solution.

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Updated (UTC)
sentry-docs	✅ Ready (Inspect)	Visit Preview	Jan 8, 2024 4:45pm

1 Ignored Deployment

Name	Status	Preview	Updated (UTC)
sentry-docs-next	⬜️ Ignored (Inspect)		Jan 8, 2024 4:45pm

[shanamatthews]

LGTM!