intro: clarify a little the paragraphs about documentation