Fix name of REST API endpoints "versioned" => "version"
Raise
Analysis
Raise
Analysis
Description
Attachments
1
Activity
Show:
Matija Polajnar June 13, 2024 at 1:37 PM
I’m fine with what the description of the task says, but I twitch when I read the title. You can’t just replace “versioned” (which is used correctly) with “version” – and of course you did not do that, which is why I agree with description. This is destructive criticism because I don’t have any advice on how to fix the title.
Ian McNicoll June 4, 2024 at 12:12 PM
Agree
Details
Details
Reporter
Pablo PazosLabels
Components
Affects versions
Priority
MediumCreated October 30, 2023 at 3:03 PM
Updated June 13, 2024 at 1:37 PM
Consider endpoints from https://specifications.openehr.org/releases/ITS-REST/latest/ehr.html#tag/EHR_STATUS/operation/versioned_ehr_status_version_get_at_time (see image attached) Get versioned EHR_STATUS version at time Get versioned EHR_STATUS version by id In both endpoints the result is a VERSION object, so it would be more accurate to name them as Get version of EHR_STATUS at time Get version of EHR_STATUS by version id I think those names reflect that the result is a VERSION not a VERSIONED_OBJECT like "versioned XXX" might imply. Note in the second one "version by id" it should be "by version id" like in "Get EHR_STATUS by version id".