readme: intro
resource plural name updates
api reference