WP-API / docs

The content for developer.wordpress.org/rest-api
https://developer.wordpress.org/rest-api
109 stars 605 forks source link

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

Open 2704jakob opened 1 year ago

2704jakob commented 1 year ago

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.

kadamwhite commented 10 months ago

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 commented 10 months ago

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

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.