core API Documentation requirements swagger.yaml - very used in java, javascript, python example: http://petstore.swagger.io/?url=https://raw.githubusercontent.com/jupyter/notebook/master/notebook/services/api/api.yaml (source yaml, ) markdown docs example: https://github.com/jupyter/jupyter/wiki/Jupyter-Notebook-Server-API