add docs for the programmatic API #85