docs: improvements for documentation and examples #546

Job	Run time
ubuntu-20.04-x64--	6m 43s
windows-2019-x64--	8m 12s
windows-2019-ia32--	9m 44s
macos-13-x64--	9m 25s
macos-14-arm64--	17m 56s
ubuntu-24.04-x64-docker/alpine.dockerfile-	2m 58s
ubuntu-24.04-arm64--bookworm	9m 10s
ubuntu-24.04-arm64--alpine_latest	8m 7s
Package	1s
SmokeTest	1s
	1h 12m 17s

Provide feedback