added reasonable object names
updated docs, added continuity to routes