document path parameter and add example