Skip to content

Conversation

@bickelj
Copy link
Contributor

@bickelj bickelj commented Aug 26, 2025

Until recently, the PDC back-end software has largely been in an experimental or prototype state. At least two parties (besides the team developing the PDC back-end) call it. We also anticipate real data to be sent to the PDC soon. Even if the software remains experimental for a while, the API has matured over the past three-plus years since its first commit. It is time to call it version one.

@codecov
Copy link

codecov bot commented Aug 26, 2025

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 93.17%. Comparing base (dec0a6c) to head (589a830).
⚠️ Report is 16 commits behind head on main.

Additional details and impacted files
@@           Coverage Diff           @@
##             main    #1869   +/-   ##
=======================================
  Coverage   93.17%   93.17%           
=======================================
  Files         287      287           
  Lines        3237     3237           
  Branches      490      490           
=======================================
  Hits         3016     3016           
  Misses        221      221           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@slifty
Copy link
Member

slifty commented Aug 26, 2025

sounds reasonable -- just a note that the versions apply to our OpenAPI specification document (which is what we mean by API version) as well as our published SDKs

To your point: we'll rapidly increase major versions since at this point / probably for a while are breaking changes, but I don't think we need to be afraid of reaching v1053

EDIT: didn't see this was a PR sorry, thought it was an issue for discussion! The above wasn't intended as an approve just yet. v1 release is a huge deal!

@bickelj bickelj mentioned this pull request Aug 26, 2025
@bickelj
Copy link
Contributor Author

bickelj commented Aug 26, 2025

@slifty It is a succinct and actionable discussion-starter, it's a PR : )

Until recently, the PDC back-end software has largely been in an
experimental or prototype state. At least two parties (besides the
team developing the PDC back-end) call it. We also anticipate real
data to be sent to the PDC soon. Even if the software remains
experimental for a while, the API has matured over the past three-plus
years since its first commit. It is time to call it version one.
@slifty
Copy link
Member

slifty commented Sep 4, 2025

Created a ticket for us to be able to talk about what policies (if any) we'll want to adopt alongside a change like this: #1895

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