3 ms·
Great summary! I use restclient to produce example calls for READMEs and stuff but I hadn’t thought to export an html view. While this really exercises the mar
by kristjansson 5y ago
Great summary! I use restclient to produce example calls for READMEs and stuff but I hadn’t thought to export an html view.
While this really exercises the markup features of org-mode and org-babel, wouldn’t literate programming have all this interleaved with the implementation at the API you’re documentating?
- joseph8th 5y agoThis approach would work just as well to document and develop, for example, a local Python API. Instead of using `restclient` source blocks, we'd be using Python blocks. Otherwise, it's the same idea. In my case, I'm documenting RESTful APIs for clients who want to write their own client code.