improve doc

Author: coderzc

pip/pip-452.md

@@ -49,9 +49,9 @@ message CommandGetTopicsOfNamespace {
 
 Add `properties` parameter to the REST API endpoint for listing topics in a namespace to list topic with specific properties for customizable topic listing.
 
-REST API:
+REST API (URL encoding is required for values):
 ```
-GET /admin/v2/persistent/{tenant}/{namespace} with a query params properties=k1=v1,k2=v2
+GET /admin/v2/persistent/{tenant}/{namespace}?properties=k1=v1,k2=v2
 ```
 
 CLI:
@@ -212,14 +212,15 @@ The regex consumer implementation (PatternMultiTopicsConsumerImpl) will be updat
 
 ```Java
 // In PatternMultiTopicsConsumerImpl.java
+ConsumerConfigurationData conf;
 Map<String, String> contextProperties = conf.getProperties();
 
 lookup.getTopicsUnderNamespace(
     namespace, 
     mode, 
     topicsPattern.pattern(), 
     topicsHash, 
-    contextProperties // Pass properties here
+    contextProperties // Pass consumer properties here
 ).thenAccept(topics -> {
     // ... update subscriptions ...
 });
@@ -238,5 +239,5 @@ Authorization: This PIP only controls the discovery (listing) of topics. It does
 
 # Links
 
-* Mailing List discussion thread:
+* Mailing List discussion thread: https://lists.apache.org/thread/nf11qzn6r9wps6l81trxwtdr1m9xszpm
 * Mailing List voting thread: