feat: Documentation improvements #2773

Job	Run time
generate-examples	2s
build (self-hosted, linux, X64)	33s
build (macos-13)	7m 4s
build (self-hosted, macOS, ARM64)	45s
build (self-hosted, linux, ARM64)	1m 0s
zsh/fish (ubuntu-latest)	48s
direnv (ubuntu-latest)	44s
zsh/fish (macos-13)	2m 57s
pin	0s
direnv (macos-13)	3m 31s
zsh/fish (self-hosted,macOS,ARM64)	9s
direnv (self-hosted,macOS,ARM64)	14s
direnv (self-hosted,Linux,ARM64)	14s
zsh/fish (self-hosted,linux,ARM64)	6s
tests (self-hosted, linux, X64)	3m 57s
tests (macos-13)	20m 28s
tests (self-hosted, macOS, ARM64)	6m 18s
tests (self-hosted, linux, ARM64)	6m 6s
	54m 56s

Provide feedback