docs: improvements for documentation and examples #547

Job	Run time
ubuntu-20.04-x64--	5m 53s
windows-2019-x64--	11m 24s
windows-2019-ia32--	9m 6s
macos-13-x64--	9m 16s
macos-14-arm64--	11m 28s
ubuntu-24.04-x64-docker/alpine.dockerfile-	3m 10s
ubuntu-24.04-arm64--bookworm	9m 19s
ubuntu-24.04-arm64--alpine_latest	8m 21s
Package	1s
SmokeTest	1s
	1h 7m 59s

Provide feedback