integrated some parts of the documentation