add documentation (phase 3)