Start of @package grouping for docs

Mundane change to add @package tags to some of the files so apigen can group things for us.  Ongoing process to get things organized in the docs.  

Also some minor formatting tweaks so lists are picked up as bullet lists and the summary and main docs are separated (for apigen)