Update cm-colors documentation with verified outputs and detailed usage explanations

[lalithaar]

The documentation for cm-colors contains example code snippets with placeholder expected outputs. This can confuse new users. Please update the documentation as follows:

What needs to be done:

• Fork and clone the cm-colors library.
• Set up a virtual environment and install the library locally.
• Run the code examples in the documentation and update the expected output values with the actual results you get.
• Add or improve explanations to make the documentation more accessible and beginner-friendly.
• If you encounter any errors in sample code, fix them as you go.
• Open a draft pull request in comfort-mode-toolkit/docs and link it to this issue.

Reference (for updating and explaining examples):

• The function CMColors.ensure_accessible_colors checks the contrast between text and background colors and, if necessary, adjusts the text color to meet WCAG AAA requirements (or AA for large text) with minimal perceptual change.
• Returns: The (potentially adjusted) text RGB, background RGB, WCAG compliance level ("AAA", "AA", or "FAIL"), initial contrast ratio, and final contrast ratio.

Getting started:

git clone [your forked repo]
cd cm-colors
python3 -m venv env
source env/bin/activate
pip install -e .

You can import the library using from cm_colors import ....

Notes:

• Make sure your updates are beginner-friendly.
• This is a good first issue for new contributors!
• For more details, you can refer to the @comfort-mode-toolkit/cm-colors repository.

[lalithaar]

An example snippet is

contrast_ratio = cm.calculate_contrast(text_color, bg_color)
print(f"Contrast ratio: {contrast_ratio:.2f}")
# Expected Output: Contrast ratio: 5.92 (or similar, depends on exact math)

After setting up the python library locally, run the code and note the actual output

Incase of any errors or help, feel free to tag me