Improve Highlighting documentation structure and language clarity #2919
Description
This is a follow-up issue for #2273.
Based on recent PR feedback, there are several opportunities to improve the Highlighting documentation for better readability and scannability:
- Review and clean up the overall language for clarity and consistency.
- Assess if the existing notes and warnings could be better integrated into the content or moved under more specific subheadings.
- In the "How the unified highlighter works" section, consider adding more subheadings to improve scannability.