[GitHub] [trafficcontrol] ocket8888 opened a new issue, #6831: Docs for /users, /users/{{ID}} and /user/current are incorrect in v4

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

ocket8888 opened a new issue, #6831:
URL: https://github.com/apache/trafficcontrol/issues/6831

   ## This Bug Report affects these Traffic Control components:
   - Documentation
   
   ## Current behavior:
   The documentation for `/users` is missing property definitions for `ucdn` in POST request bodies, and `changeLogCount`, `lastAuthenticated` and `ucdn` in POST method responses.
   
   The documentation for `/users/{{ID}}` is missing a property definition for `ucdn` in GET method responses, and it's missing property definitions for `changeLogCount` and `lastAuthenticated` in PUT method responses.
   
   The documentation for `/user/current` includes a property definition in GET responses for `registrationSent`, but that property doesn't exist in GET responses from that endpoint don't exist. The response description for PUT requests lists no property definition for `changeLogCount`, `lastAuthenticated`, nor `ucdn`, but all are present in responses. The response example for that method also is missing those properties.
   
   These endpoints all also incorrectly list `ucdn` fields as being introduced in the non-existent APIv6.2 - should be ATCv6.2.
   
   ## Expected behavior:
   The docs should be correct
   
   ## Steps to reproduce:
   Read the docs
   


-- 
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: issues-unsubscribe@trafficcontrol.apache.org.apache.org

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

[GitHub] [trafficcontrol] shamrickus closed issue #6831: Docs for /users, /users/{{ID}} and /user/current are incorrect in v4

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

shamrickus closed issue #6831: Docs for /users, /users/{{ID}} and /user/current are incorrect in v4
URL: https://github.com/apache/trafficcontrol/issues/6831


-- 
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: issues-unsubscribe@trafficcontrol.apache.org

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