Project documentation (PHP+JavaScript). How to build a documentation system for two languages ​​+ auto-build (Gulp)?

Question

PHP

Good afternoon friends!
Here's something that makes me feel bad from the volume of written code and comments, I set out to set up automatic assembly of project documentation.
PHP+JavaScript project The
requirements are as follows:
- It is desirable to have the same documentation principles (markup, tags) for both PHP and JS
- The ability to specify for a method to include it in the documentation or not, not all methods need to be published in JS, so as not to clog the brain of those who will use the component's private functions.
JsDoc + PHPdoc + Gulp?

Answer 1

For api you can use swagger.io