If the example in this chapter did not sell you on the benefits of documenting your code using the phpDoc syntax, you only need to take a look at the API documentation of some of the biggest PHP projects out there, such as Zend Framework and Pear. There is a reason that this method of documenting source code has been around for over ten years. Programmers quickly get the big picture of how the various components come together. Moreover, it also allows them to drill down to the granular level of parameters, return values, and so on.
If you are not in the habit of commenting your code, I suggest you start slowly. Rather than documenting every single element, start with file and class-level DocBlocks. I suspect that you will quickly get used to creating documentation at the same time as code especially when you see the results in the form of detailed and useful documentation. Hopefully, you will feel encouraged enough to start documenting more elements and produce documentation that...