Comprehensive documentation review and update #387

Job	Run time
Rust Unit Tests (macos-latest)	1m 6s
Rust Unit Tests (windows-latest)	2m 12s
Pure Python Fallback	44m 51s
Python Tests (macos-latest, py3.13)	6m 0s
Python Tests (ubuntu-latest, py3.11)	12m 0s
Python Tests (windows-latest, py3.13)	12m 57s
Python Tests (macos-latest, py3.11)	6m 44s
Rust Unit Tests (ubuntu-latest)	1m 20s
Python Tests (ubuntu-latest, py3.13)	12m 34s
Python Tests (windows-latest, py3.11)	13m 25s
	1h 53m 9s

Provide feedback