update documentation with implementation notes and consolidate previous files