3 ms·

i have seen those in annotated javascript documentation. but it was the other way around. (comment on the left, and code on the right). they all seem to use doc

i have seen those in annotated javascript documentation. but it was the other way around. (comment on the left, and code on the right). they all seem to use docco[0] with the option to display comment in "parallel". the author of docco used it in their library underscore[1]. [0]: https://github.com/jashkenas/docco https://github.com/jashkenas/docco [1]: https://underscorejs.org/docs/underscore-esm.html https://underscorejs.org/docs/underscore-esm.html

glaucon 4y ago
This is spot on, thanks. In fact I'm reasonably sure that it was 'docco' I was remembering having seen in the past. While digging around with your references I came across Pycco [1] which is a python optimized version of docco and as it's Python I'm trying to document that's a very useful thing to find. Thanks. [1] https://pycco-docs.github.io/pycco/ https://pycco-docs.github.io/pycco/