document the annotation structrure and update route syntax