docs: redo events guide

[AstreaTSS]

Pull Request Type

• Feature addition
• Bugfix
• Documentation update
• Code refactor
• Tests improvement
• CI/CD pipeline enhancement
• Other: [Replace with a description]

Description

This PR aims to redo the events guide, which has been a pain point for a large amount of users. The guide itself is too short, uses unclear language, and does not give proper warnings about what not to do.

This PR does not give a whole list of events, nor is there intention to. It is to my belief that lists of events already exist in the API documentation - I believe adding more information about how events work will outset the need to create a redundant list that will need constant updating. However, if enough people disagree, I can add it in.

Changes

This is largely a "see the diff" PR. That being said...

• Completely revamp the events guide. It attempts to mitigate some pain points that people mentioned during feedback, and clarifies on other sections that could use it.
• Remove the name disclaimer from the two event API Reference pages.

Related Issues

Test Scenarios

Python Compatibility

• I've ensured my code works on Python 3.10.x
• I've ensured my code works on Python 3.11.x

Checklist

• I've run the pre-commit code linter over all edited files
• I've tested my changes on supported Python versions
• I've added tests for my code, if applicable
• I've updated / added documentation, where applicable

[AstreaTSS]

Marking as ready to review.

[AstreaTSS]

Most changes that were requested have been accounted for, but I put my two cents for the two final ones.

[AstreaTSS]

Added back example usage in the API reference as discussed in Poll's review.