We should not keep a minified version of respec.js
Problem
There are 2 minified versions of respec.js for 3.x and for 4.x versions. These files exists in the gh-pages:
/js/respec-oai.js/js/respec-arrazzo.js
These files are basically unmaintainable and should instead try to store a human-readable version of it.
Proposed solution
There is a respec-oai.build.js.map which might help us decouple the minified version respec-oai.js.
After we succeed in decoupling the file and keep only the source code in our repo, we need to add a build step in our deploy process so we can push the minified version again.
In addition we should update to the latest version of ReSpec and have a documented process to refresh our snapshot.
Which also means we should not "fork" or otherwise modify the original ReSpec, and use the same snapshot for OpenAPI and Arazzo.
Differences between OAI snapshots of ReSpec 21.0.1 and the original:
- Added Apache2 license
- doesn't seem to have any visible effect in the rendered spec
- Tweaked Copyright line
- can (now) be done per document
- Changed linter defaults
- can be done via respecConfig
- Changed logo image and url
- can be done via respecConfig
- Changed section heading of "abstract"
- can (now) be done per document
- this is the only difference between the OpenAPI and Arazzo clones of ReSpec
- Changed DateTimeFormat from Australian English to British English
- what's the difference?