Docstring updates (#921) #1611

Job	Run time
CMake correctness checks	6s
Coverage	3m 43s
Test Compile gcc Debug	3m 46s
Test Compile clang Debug	3m 45s
Test Compile gcc Release	2m 34s
Test Valgrind	13m 41s
Test Compile clang Release	2m 37s
Test Compile clang Debug -fsanitize=undefined,float-divide-by-zero -fno-sanitize-recover=undefined,float-divide-by-zero	5m 49s
Test Compile clang Release -fsanitize=undefined,float-divide-by-zero -fno-sanitize-recover=undefined,float-divide-by-zero	3m 1s
Test Compile clang Debug -fsanitize=memory -fno-sanitize-recover=memory	5m 50s
Test Compile clang Release -fsanitize=memory -fno-sanitize-recover=memory	5m 33s
Test Compile clang Debug -fsanitize=address -fno-sanitize-recover=address	5m 40s
Test Compile clang Release -fsanitize=address -fno-sanitize-recover=address	3m 30s
	59m 35s

Provide feedback