feat: add mintlify docs publish job (ENG-841) (#374)

Author: effervescentia

.editorconfig

@@ -0,0 +1,15 @@
+# EditorConfig: https://EditorConfig.org
+
+# top-most EditorConfig file
+root = true
+
+[*]
+indent_style = space
+indent_size = 2
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.json]
+trim_trailing_whitespace = false

.vscode/settings.json

@@ -0,0 +1,21 @@
+{
+  "[json]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "[jsonc]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "[markdown]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "[yaml]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "[toml]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "editor.codeActionsOnSave": {
+    "source.fixAll.eslint": "explicit"
+  },
+  "eslint.format.enable": true
+}

src/jobs/monorepo/monorepo_mintlify_publish.yml

@@ -0,0 +1,46 @@
+parameters:
+  schema_dir:
+    description: Directory to store schemas between jobs
+    type: string
+    default: "/tmp/schemas"
+  docs_repo:
+    description: Repository containing Mintlify docs
+    type: string
+    default: "docs-v2"
+  executor:
+    description: Executor to run the command on
+    type: executor
+    default: node-executor
+executor: << parameters.executor >>
+steps:
+  - checkout_clone
+  - attach_workspace:
+      at: ~/voiceflow
+  - install_node_modules
+  - openapi_restore_schemas:
+      attach_workspace: true
+      from: "<< parameters.schema_dir >>"
+      to: ~/voiceflow
+  - clone_repo:
+      step_name: Clone Mintlify docs repository
+      github_username: GITHUB_USERNAME
+      github_token: GITHUB_TOKEN
+      github_repo_name: "<< parameters.docs_repo >>"
+      path_to_clone: ~/docs
+  - run:
+      name: Commit public OpenAPI schemas to Mintlify docs repo
+      command: |
+        yarn schema:extract:public
+
+        # copy schemas to docs repo
+        cd apps
+        cp -v --parents */openapi.public.json ~/docs/specs
+
+        # within the docs repo
+        cd ~/docs
+        git config --global user.email "serviceaccount@voiceflow.com"
+        git config --global user.name "Voiceflow"
+        git add specs/*/openapi.public.json
+        git diff-index --quiet HEAD || git commit -m "feat: evolve ${CIRCLE_PROJECT_REPONAME} schemas"
+        git pull --rebase
+        git push