+ added some text and references to the documentation