Demonstrate Microcks Mocking (#21)

* getting examples working with microcks

* chore: add microcks spectral rulset

This will help make sure the OpenAPI is working well within Microcks.

* feat: mark production as not internal

* feat: name more examples in pairs for microcks

* added mock server to servers

* remove caching stuff for now

* Silence failing rules for microcks

* bring back seat preferences later

* allow microcks back in for linting

* revert main openapi.yaml and make a overlay / generated openapi.mock.yaml

* add a script to remind me how to do this

* disable linting on microcks openapi.yaml as it uses string examples

* Regex...

.github/workflows/lint.yml

@@ -27,8 +27,9 @@ jobs:
           fetch-depth: 0
 
       - name: Super-linter
-        uses: super-linter/super-linter@v6.0.0
+        uses: super-linter/super-linter/[email protected].0
         env:
           DEFAULT_BRANCH: main
-          VALIDATE_OPENAPI: true
+          FILTER_REGEX_INCLUDE: ^openapi.yaml
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          VALIDATE_OPENAPI: true