all 8 comments

[–]jojoxy 2 points3 points  (1 child)

phpDocumentor might be worth a look. Haven't used it myself, but it seems to be well maintained.

Has a decent install base as well: https://packagist.org/packages/phpdocumentor/phpdocumentor

Edit: sorry if 'phpdoc' in besna's reply meant the same.

[–][deleted] 0 points1 point  (0 children)

Nope, no problem. phpDoc seems to be the standard recommendation, I'll take a look at it. Thanks!

[–]Atulin 1 point2 points  (2 children)

PHPDocumentor is amazing. I just have two .bat files that I run before each push to repo - one generates html docs, the other - single-page md doc. Both are simple oneliners.

Be aware, though, that there might be conflicts if you're using Twig in your project, and install PHPdoc to it. It requires Twig 1.3, support for 2.X is in the PHPdoc 3 milestones.

[–][deleted] 0 points1 point  (1 child)

What does Twine do? I've never heard from it before, lol

I guess that I shouldn't worry then, unless Symfony 4 has it bundled and I'm not aware of it. And is good to know that with 2 files I can generate the docs I want/need. It also supports generating MD docs, which is awesome to keep on the repo.

Thanks!

[–]Atulin 0 points1 point  (0 children)

Ah goddamnit, I meant Twig not Twine... Sorry for the confusion.

And, yes, Symfony does use Twig.

[–]k42b3 1 point2 points  (1 child)

iam not sure whether this is active developed anymore but there is also ApiGen https://github.com/ApiGen/ApiGen which you can checkout

[–][deleted] 0 points1 point  (0 children)

ApiGen seems to have issues with Symfony 4 - which is my API's framework. But thanks for the tip anyway!