Documentation improvements: doc set & API docs

The doc set needs more improvements and the API docs need editing, updating, and filling-in-the-blanks. (75% of description lines in the API doc index are blank. But class descriptions have better stats – only 45% blank.)