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

Implement Swagger for the Quantum API #945

Open
mikhail-zlochevskyi opened this issue Apr 21, 2023 · 3 comments
Open

Implement Swagger for the Quantum API #945

mikhail-zlochevskyi opened this issue Apr 21, 2023 · 3 comments
Labels
area/api kind/feature New feature request needs/priority Needs a priority label needs/triage Waiting for triage to be accepted

Comments

@mikhail-zlochevskyi
Copy link
Contributor

What would you like to be added:

https://blog.bitsrc.io/a-guide-to-nestjs-swagger-configuration-dec5f183b53

Why is this needed:

For transparency of the api test coverage, declarative form of usage, etc

  • Improves the experience for developers using our API;
  • Decreases the amount of time spent on-boarding new users (internal developers or external partners). New users will start being productive earlier and will not depend on a person (already with the knowledge) who would need to spend slots of their time to explain how the API is design and how it works;
  • Leads to good product maintenance and quicker updates. It helps your internal teams know the details of your resources, methods, and their associated requests and responses, making maintenance and updates quicker;
  • Agreement on API specs for the endpoints, data, types, attributes and more. And this helps internal and external users to understand the API and know what it can do;
  • The API contract can act as the central reference that keeps all the team members aligned on what your API’s objectives are, and how the API’s resources are exposed;
  • Unblocks development on different sides (front-end / back-end / mobile development) due to dependencies on specification;
  • Allows identifying bugs and issues in the API’s architecture when defining it with the team;
  • Decreases the amount of time (and headaches!!!) spent on understanding how the API works and deciphering unexpected errors when using it.
@mikhail-zlochevskyi mikhail-zlochevskyi added the kind/feature New feature request label Apr 21, 2023
@github-actions github-actions bot added the needs/triage Waiting for triage to be accepted label Apr 21, 2023
@github-actions
Copy link

@mikhail-zlochevskyi: Thanks for opening an issue, it is currently awaiting triage.

The triage/accepted label can be added by foundation members by writing /triage accepted in a comment.

Details

I am a bot created to help the BirthdayResearch developers manage community feedback and contributions. You can check out my manifest file to understand my behavior and what I can do. If you want to use this for your project, you can check out the BirthdayResearch/oss-governance-bot repository.

@github-actions github-actions bot added the needs/area Needs area label(s) label Apr 21, 2023
@github-actions
Copy link

@mikhail-zlochevskyi: There are no 'area' labels on this issue. Adding an appropriate label will greatly expedite the process for us. You can add as many area as you see fit. If you are unsure what to do you can ignore this!

You can add area labels by leaving a /area comment.

Details

I am a bot created to help the BirthdayResearch developers manage community feedback and contributions. You can check out my manifest file to understand my behavior and what I can do. If you want to use this for your project, you can check out the BirthdayResearch/oss-governance-bot repository.

@github-actions github-actions bot added the needs/priority Needs a priority label label Apr 21, 2023
@github-actions
Copy link

@mikhail-zlochevskyi: Thanks for opening an issue, an appropriate priority will be added soon.

The priority labels can be added by foundation members by writing /priority [type] in a comment.

Details

I am a bot created to help the BirthdayResearch developers manage community feedback and contributions. You can check out my manifest file to understand my behavior and what I can do. If you want to use this for your project, you can check out the BirthdayResearch/oss-governance-bot repository.

@mikhail-zlochevskyi mikhail-zlochevskyi removed their assignment Apr 21, 2023
@mikhail-zlochevskyi mikhail-zlochevskyi added area/api kind/docs Non feature documentation change and removed needs/area Needs area label(s) needs/triage Waiting for triage to be accepted needs/priority Needs a priority label labels Apr 21, 2023
@github-actions github-actions bot added needs/triage Waiting for triage to be accepted needs/priority Needs a priority label and removed kind/docs Non feature documentation change labels Apr 21, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area/api kind/feature New feature request needs/priority Needs a priority label needs/triage Waiting for triage to be accepted
Projects
None yet
Development

No branches or pull requests

2 participants