Update docs for analyzers

[olstakh]

This pull request significantly improves the documentation for analyzer rules in the docs/Rules directory by adding clear violation examples, detailed suppression guidance, and additional context for each rule. These changes make it easier for users to understand, diagnose, and address rule violations related to dependency-aware test ordering in xUnit.

Key documentation improvements:

• Violation Examples and Fixes

  • Added explicit code examples showing violations for each rule, making it clear what triggers each analyzer warning. [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11] [12] [13] [14] [15]

• Suppression Guidance

  • Added "When to suppress" sections to each rule, explaining when (and when not) to suppress warnings, and linking to suppression instructions. [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11] [12] [13] [14] [15]

• MSBuild Property Alternatives

  • Clarified the use of MSBuild properties (e.g., <UseDependencyAwareTestCaseOrderer>, <UseDependencyAwareTestFramework>) as alternatives to manual attribute configuration for several rules. [1] [2] [3] [4] [5] [6] [7]

• Custom Implementation Guidance

  • Provided advice on custom orderer/framework implementations, including inheritance requirements to ensure dependency ordering works as expected. [1] [2] [3]

• Consistency and Clarity

  • Standardized the structure of documentation for all rules, ensuring each rule has sections for violation, how to fix, suppression, and relevant code examples. (All references above)

These enhancements will help users quickly identify and resolve test dependency configuration issues in their xUnit test suites.