continuing a large expansion of the documentation