mpdf.github.io icon indicating copy to clipboard operation
mpdf.github.io copied to clipboard

Using phpdoc

Open machour opened this issue 6 years ago • 1 comments

Browsing through mpdf source code, I noticed several inline comments mentioning versions where a particular change occurred. Some examples:

if (!empty($attr['POSITION'])) {  // mPDF 5.7.2

I also noticed that the documentation is maintained by hand, and that some of the latest changes in mPDF are not yet reflected (which is completely understandable).

I was wondering if phpdoc could be used more efficiently in the source code, in order to generate the documentation. I know this will require a lot of work, and I'm willing to participate here as well :)

Let me know what are your thoughts on this subject.

machour avatar Nov 20 '17 09:11 machour

Hi @machour , generated documentation would be an excellent project, as the existing static documentation is under a restrictive licence and cannot be updated without permission from the author, a permission we do not have. See https://github.com/mpdf/mpdf.github.io/blob/development/copyright.md

danielhjames avatar Nov 20 '17 10:11 danielhjames