api: correcting file names & adding more reference documentation