Document programmatic API

[sindresorhus]

We should document the programmatic API (#279) eventually, but for now I'd like to keep it undocumented so we're free to change around things as we please.

[novemberborn]

Let's move the discussion to #1043.