reorganizing the documentation to be more consistent across the API
and describe how API keys are used in one place