add some phpDocs