As noted in the section outlining
Comments & External Documentation, each file should begin with a block comment detailing important information about the file. In addition to the default block comment, the class should include PHPDoc comments sufficient to produce a full
API for the given class and/or package.