UPDATE: continued updating of documentation