partial documentation update + more to come