added documentation links
identified some todos
addressing todo items