Releases: readmeio/github-readme-sync
Deprecated in favor of our new GitHub Action!
This GitHub Action repository is now deprecated in favor of rdme
, which has GitHub Action support for syncing OpenAPI files, directories of Markdown files, and more. Workflows using this repository will continue to function normally, but development and support related this repository is now closed and this repository is archived. Check out our docs to learn more!
ReadMe Base URL Update
This updates our base URL to dash.readme.com to reflect our latest guidance on accessing the ReadMe API.
Validation enhancements, other minor bug fixes
This resolves some issues introduced in v2.1.0
with OpenAPI/Swagger file validation. The validation is now performed by the ReadMe API during upload, rather than performing a validation beforehand.
Additionally, this fixes some false positives in the workflow's error handling.
OpenAPI/Swagger validation, Step Debug Logs, and more!
Highlights of this release include:
- OpenAPI/Swagger file validation prior to upload
- Step Debug Logs for troubleshooting workflow failures
- Error messages — now with 100% more clarity and whimsy! (Be sure to check out our blog post on why we did this)
- This should also resolve issues that folks may have been seeing with unhelpful error messages (e.g. #23)
This release also includes minor housekeeping, such as bumping various dependencies and removing extraneous ones.
Version 2.0: Simplified setup and configuration!
This is a big release to our GitHub Action! We've dramatically simplified the configuration required and try to infer as much as possible.
Now there is only one required parameter,readme-oas-key
which can be obtained from the ReadMe dashboard when initially syncing your API.
There are two optional parameters that can be passed in:
oas-file-path
: path to the spec file to be synced (Default: we try to find a file automatically)api-version
: version in ReadMe to sync the API spec to (Default: version defined within the spec file)
1.0.3
1.0.2
1.0.1
Initial Release
Initial release of a GitHub Action to sync with ReadMe! View our docs on getting setup here: https://docs.readme.com/docs/automatically-sync-api-specification-with-github