Add JavaDocs for end-user API

Why is this plural?