Documented and supported low-level API

Currently, the only documented API is probot run ./app.js and the methods on robot and context objects. There are a lot of good reasons for publishing and documenting low-level APIs (building extensions, embedding probot in other apps, and testing–to name a few). I’d like to see us get to a point where we have a documented low-level API that is semantically-versioned.

TODO:

• Expose methods for creating internal modules #399
• Extract logic from probot run into a reusable module

What else?

[hiimbex]

Can this be closed in favor of https://github.com/probot/probot/issues/599 which is more up to date from our ts update?

[gr2m]

I think this is resolved with the latest probot version now. Probot is much more decomposable into Probot modules and the underlying Octokit modules. What’s left is documenting how to “eject” probot if your app outgrows the project scope.

For the time being, feel free to ask any questions here.

With the upcoming v11, I want to build Probot on top of https://github.com/octokit/app.js/, which will make it even more decomposable