docs/ rest_url_design reviewed