readd some important information to phpDocs