docs icon indicating copy to clipboard operation
docs copied to clipboard

Properly distinguish list-item and get-item routes in Application Passwords reference

Open 2704jakob opened this issue 2 years ago • 2 comments

I'm new to contributing so please tell me, if I did something wrong. In the Application Passwords reference were 2 duplicates. Retrieve and Delete. The first retrieve and delete missed the / at the end of the example. And after the Schema Section was a stry which I removed aswell.

2704jakob avatar Feb 03 '23 05:02 2704jakob

The /reference/ folder is auto-generated from the code, so removing these from the generated markdown will not be a permanent change. Thanks for calling out the duplication -- we'll need to look at the templating for these reference files to see if we can protect against this issue.

kadamwhite avatar Aug 31 '23 19:08 kadamwhite

@2704jakob I re-read the documentation, and realized what's going on: There are two separate routes contained in this reference page,

  • GET /wp/v2/users/<user_id>)/application-passwords
  • GET /wp/v2/users/<user_id>)/application-passwords/<uuid>

These are different routes, not a duplication. I agree it is very unclear what's going on, and think we actually have an issue with the list endpoint (the one without the ) being generated with the get-item template instead of the list-item template.

The first endpoint should read, "List Application Passwords". We'll look into why this is getting mis-paired.

kadamwhite avatar Aug 31 '23 19:08 kadamwhite