document the REST and frontend pattern we use