Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Endpoints description fixes #148

Merged
merged 2 commits into from
Oct 8, 2024

Conversation

mbaudis
Copy link
Member

@mbaudis mbaudis commented Jul 17, 2024

The OpenAPI endpoints files included a number of leftover or potentially misleading descriptions, e.g.:

  • "get a list of..." as description for responses, although responses depend on granularity and delivered in different Beacon response schemas
  • frequent use of "variant" instead "variation"
  • some wrong labels (e.g. C&P errors or leftover "examples" response)
  • renaming of some operation ids which had misleading names

Additionally the leftover commented lines from the yamlerRunner have been removed.

These are non-breaking changes, restricted to the description fields in endpoints files. JSON versions were generated from YAML sources.

The OpenAPI `endpoints` files included a number of leftover or potentially misleading descripions, e.g.:
* "get a list of..." as description for responses, although responses depend on granularity and delivered in different Beacon response schemas
* frequent use of "variant" instead "variation"
* some wrong labels (e.g. C&P errors or leftover "examples" response)

Additionally the leftover commented lines from the yamlerRunner have been removed.
@mbaudis mbaudis requested a review from costero-e July 17, 2024 11:50
@mbaudis
Copy link
Member Author

mbaudis commented Jul 17, 2024

Pinging @datsirul here FYI.

Copy link
Collaborator

@costero-e costero-e left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Great @mbaudis !, I see variants for genomic variations and list for beacon response are the main changes. I am not an expert on terminology but if this fits better to the spec, it's good.
The only thing I have seen is maybe the Get a *analyses* response for one experimental run, identified by its which could be an analyses, like Get an *analyses* response for one experimental run, identified by its.

@costero-e costero-e merged commit 1e8c9a0 into schema-urgent-fixes Oct 8, 2024
1 check passed
@costero-e costero-e deleted the endpoints-description-fixes branch December 13, 2024 08:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants