documenting case classes and service route