diff --git a/README.md b/README.md index e45e815..a3a6bbe 100644 --- a/README.md +++ b/README.md @@ -42,6 +42,21 @@ Pull requests are welcome and encouraged! For details, please see [CONTRIBUTING.md](CONTRIBUTING.md). +### Updating the OpenAPI Specification + +There is a modified version of the Console Connect OpenAPI specification included in the repository. +To update the spec, simply remove the old specification from the `specs/` folder and push a new +version with the filename `ccapi_YYYYMMDD.json`, where YYYY is the 4 digit year, MM is the two +digit month, and DD is the two digit day. Then update the filename in `src/app.ts` to match. + +To try out a new specification file locally, you can pass in the path to the file through the +environment variable `SPEC_FILE`. For example: + +```bash +export SPEC_FILE="./specs/mytestapi.json" +yarn dev +``` + ## License [Apache 2.0](LICENSE)