add some critical documentation