This repository is a fork of instill-ai/protobufs that serves as a playground for developing a GitHub action that syncs the public API reference, hosted in ReadMe, with the Instill Core.

There are 3 public OpenAPI references (Core, Model and VDP), which version points to the latest Instill Core version (perhaps model should have a different release version.

Every time a new Instill Core release is published, a GitHub action creates a PR updating the version in the OpenAPI documents. Once this is merged, we have to manually re-sync the public documentation.

🎉 Changes were merged in instill-ai#270

• Having a private version of the API references that we can keep in sync with the main branch in the protobufs repo in order to QA the documentation before syncing the public version.
• Syncing the public version automatically when the version update PR is merged.

• On main branch merge: update staging docs
• On version PR merge: update production docs

2 versions per (major) Core release: public and private.

As we have 3 docs per version, we can either keep the IDs as variables in our workflow or obtain them from the ReadMe API.

• On main branch merge: update staging docs
• On version PR merge: create new (main, beta, public) version with staging one as base.

• 1 public version per Core release.
• 1 private version per major Core release.

We can keep the private API IDs constant, then create new main versions from them as releases occur.

ReadMe limits the number of versions a subscription plan can have, so adding a new version each release cycle does not scale. We'll go back to one public version and a private one. The name of the private version will point to the latest Core release and if we need to support several major versions we can have different endpoint collections (e.g. VDP v2) within the same version.

• 1 public version e.g. v0.12.0-beta (version will point to Core release)
• 1 staging version v0-beta-staging (we might change the name when Core is at 1.x.x but we shouldn't create a new version. The IDs of this version will be tied to the workflow).

We'll keep the private API IDs constant, then create new main versions from them as releases occur.

• On version PR merge: create tag with version
• On Core GitHub action PR: generate link with diff.