sijie commented on a change in pull request #4367: [document][swagger]Update 
topics rest api document
URL: https://github.com/apache/pulsar/pull/4367#discussion_r287554772
 
 

 ##########
 File path: 
pulsar-broker/src/main/java/org/apache/pulsar/broker/admin/v2/PersistentTopics.java
 ##########
 @@ -78,7 +83,10 @@
     @ApiOperation(value = "Get the list of partitioned topics under a 
namespace.", response = String.class, responseContainer = "List")
     @ApiResponses(value = { @ApiResponse(code = 403, message = "Don't have 
admin permission"),
             @ApiResponse(code = 404, message = "Namespace doesn't exist") })
-    public List<String> getPartitionedTopicList(@PathParam("tenant") String 
tenant,
+    public List<String> getPartitionedTopicList(
+            @ApiParam(value = "Specify the tenant to which this topic 
belongs", required = true)
+            @PathParam("tenant") String tenant,
+            @ApiParam(value = "Specify the namespace to which this topic 
belongs", required = true)
 
 Review comment:
   the comment " which this topic belongs" is wrong here. the action is to 
fetch the list of topics for a given namespace, we don't know any topic yet, no?

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
[email protected]


With regards,
Apache Git Services

Reply via email to