Expanded docs for proposed RESTful URLs