initial annotated docs shiz. looooong way to go