-
-
Notifications
You must be signed in to change notification settings - Fork 253
Labels
docs 📃Improvements or additions to documentationImprovements or additions to documentationfeature 🚀New feature or requestNew feature or requestinternal ⚙️Internal development relatedInternal development related
Description
We want our examples living in the examples folder (except for examples/openapi-ts-sample) to be deployed to StackBlitz and kept in sync with the latest code as we merge features into the main branch. There are two parts to this task:
- We want to build examples, generate code using openapi-ts, and test examples as part of every CI run just like we do with regular packages. This is to ensure merging a new feature doesn't break any examples. If so, we need to update them before merging. This would function similar to snapshot tests, so we should have a simple command to update generate code in examples, just like we have
pnpm test:updatefor updating all snapshots. In the end, this step ensures ourexamplesdirectory is always kept up-to-date with the code in the same branch. - When we make a new release using changesets, after we publish a new version to npm, we want to update live examples hosted on StackBlitz. Currently, these are maintained manually and there's only a subset of examples from the
examplesfolder on StackBlitz due to the effort required to maintain them. We want to ensure the StackBlitz URL for any example would never change once it's first published, so we can reference a permalink to each example. The challenge here will be to wait until the new version is published on npm, so when we update StackBlitz, it's correctly pulling the latest version. In the end, this step ensures ourexamplesdirectory is always kept up-to-date with the released version.
Feel free to split this issue into two pull requests and start with the simpler step 1 before moving onto step 2. Feel free to ask clarifying questions.
Copilot
Metadata
Metadata
Assignees
Labels
docs 📃Improvements or additions to documentationImprovements or additions to documentationfeature 🚀New feature or requestNew feature or requestinternal ⚙️Internal development relatedInternal development related