additional documentation & examples #368

Job	Run time
g++-11, Release, Static	3m 16s
g++-11, Release, Shared	4m 7s
clang++-14, Release, Static	3m 30s
clang++-14, Release, Shared	3m 3s
clang++-15, Release, Static	3m 2s
clang++-15, Release, Shared	3m 50s
g++-11, RelWithDebInfo, Static	3m 47s
g++-11, RelWithDebInfo, Shared	3m 52s
clang++-14, RelWithDebInfo, Static	3m 16s
clang++-14, RelWithDebInfo, Shared	3m 5s
clang++-15, RelWithDebInfo, Static	3m 19s
clang++-15, RelWithDebInfo, Shared	3m 47s
	41m 54s

Provide feedback