reorg of documentation and notes