updated original documentation (not finnished)