if you are using emacs you can also give this a shot https://github.com/federicotdn/verb

It lets you write the api, test it and generate the documentation all from the same source of truth file.