bunch of changes to documentation; reorganization and cleanup