Improve documentation

Jens Luchtrequested to merge
improve-docs into master

Add clarifications and rename sphere projection to more correctly ball projection.

Merge request reports