API docs: define rough user experience, workflows

Created by: slimsag