I'm building restful (trying..) api for application with micro from phalcon. And it have many incoming points with relations.
What best practicies to automatically write documentation/reference to that api?
- Automatic generating html/markdown/some other visuals for other developers
- Automatic updates to docs/refs when code is changed
- Automatic testing/asserting responses from development version of api
Maybe, already exists tool for autograb from MicroCollections/MicroApp or something similar?
ps: sorry for my poor english ):