title: Resources for writing good PHP documentation
body: <p>I am getting a tool ready to make the source public.  I would like to have it well documented for people who would use it as well as potential contributors.  I am already using some rudimentary docblocks and some line comments for class variables.  Currently I am using doxygen because it integrates into eclipse, but I am not wedded to it.</p>
  
  <p>What I would really like to do is create documentation along the lines of <a href="http://us3.php.net/manual/en/class.pdo.php" rel="nofollow">PHP's PDO classes</a> with the class functions documented and examples of use given.  I would prefer the documentation in the code.</p>
  
  <p>What books, tutorials, or code examples would you suggest I look at to give me insight on how to craft great documentation.</p>