Document the package API extension for buildpacks

Finishes story: https://www.pivotaltracker.com/story/show/71276094