api: improving overview document to describe what classes & methods are