[GitHub] [pulsar-site] Anonymitaet commented on a diff in pull request #378: [doc][improve] add instructions for REST API JSON files and fix 404 issues

[GitBox <gi...@apache.org>]

Anonymitaet commented on code in PR #378:
URL: https://github.com/apache/pulsar-site/pull/378#discussion_r1067677858


##########
docs/admin-get-started.md:
##########
@@ -34,7 +34,9 @@ If you have enabled authentication, you need to provide an auth configuration to
 </TabItem>
 <TabItem value="REST API">
 
-You can find details for the REST API exposed by Pulsar brokers in this {@inject: rest:document:/}.
+You can find details for the REST API exposed by Pulsar brokers in the [REST API doc](reference-rest-api-overview.md).
+
+If you want to test REST APIs in postman, you can use the REST API JSON files [here](https://pulsar.apache.org/swagger/master/).

Review Comment:
   @yuweisung I add this instruction here **temporarily** because:
   
   1) From the user learning perspective, users will be interested in "testing" it after "trying" it
   
   2) From the content perspective, for existing content, here is the most relevant part. 
   
   We can relocate this instruction to other places if we have more related content in the future. 



-- 
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.

To unsubscribe, e-mail: commits-unsubscribe@pulsar.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org