update docs, rewriting some parts