I'm moving some codebases to PHP namespaces, and as a result I could no longer use my crappy API documentation script.

So, I needed a replacement, and with the help of PHPDocumentor, I was able to create a simple package that outputs github-compatible markdown documentation, based on twig templates.

Here's an example.

It's not perfect yet, but hopefully useful for others in the same boat. You can find the project and setup instructions here:

https://github.com/evert/phpdoc-md.