reworking the main index page with some more content and improved description of the documentation; fixing up a couple of warnings about docs that are not included anywhere