Update Styling Best Practices Documentation

[coderabbitai]

The documentation around styling best practices, specifically within the 'Styling Components' section of the component development guide, has been marked as needing a complete rewrite. This issue tracks the progress and plans for updating this crucial part of our documentation to reflect current standards and best practices.

Context:

• The alert within the documentation indicates a need for a comprehensive update.
• Relevant section: packages/documentation/outline-docs/src/guides/development/component-development/03-styles.mdx

This update aims to provide clear, actionable guidance on styling components within the project, incorporating modern CSS techniques and best practices.

Contributors are invited to discuss and contribute to the rewrite process, ensuring our documentation remains a valuable resource for all users.

PR for reference: #438
Comment for context: #438 (comment)