better (?) structure for index and table of contents
updating documentation (mostly structure)