docs additions and reorganization