Host Javascript API docs (close #1255)

PR #1256
* Add docs workflow
* Remove old docs folder
* Update publish workflow

Author: Jack-Keene

.github/workflows/docs.yml

@@ -0,0 +1,31 @@
+name: Deploy to GitHub Pages
+
+on:
+  workflow_run:
+    workflows: ['Deploy Tracker']
+    types:
+      - completed
+permissions:
+  contents: write
+
+jobs:
+  deploy:
+    name: Deploy to GitHub Pages
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - uses: actions/setup-node@v3
+        with:
+          node-version: 18
+
+      - name: Install dependencies
+        working-directory: ./api-docs
+        run: npm install
+      - name: Build website
+        working-directory: ./api-docs
+        run: npm run build
+      - name: Deploy to GitHub Pages
+        uses: peaceiris/actions-gh-pages@v3
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./api-docs/build

.github/workflows/publish.yml

@@ -67,18 +67,18 @@ jobs:
         working-directory: ./trackers/browser-tracker
         run: |
           api-extractor run
-          api-documenter markdown --input-folder temp --output-folder docs/markdown
+          api-documenter markdown --input-folder temp --output-folder ../../api-docs/docs/browser-tracker/markdown
 
       - name: Create API documentation for @snowplow/node-tracker
         working-directory: ./trackers/node-tracker
         run: |
           api-extractor run
-          api-documenter markdown --input-folder temp --output-folder docs/markdown
+          api-documenter markdown --input-folder temp --output-folder ../../api-docs/docs/node-tracker/markdown
 
       - name: Apply API documentation updates
         run: |
-          git add trackers/browser-tracker/docs
-          git add trackers/node-tracker/docs
+          git add api-docs/docs/browser-tracker
+          git add api-docs/docs/node-tracker
           git commit --no-verify --allow-empty -m "Applying documentation updates."
           git push
 

api-docs/.gitignore

@@ -0,0 +1,20 @@
+# Dependencies
+/node_modules
+
+# Production
+/build
+
+# Generated files
+.docusaurus
+.cache-loader
+
+# Misc
+.DS_Store
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*

api-docs/babel.config.js

@@ -0,0 +1,3 @@
+module.exports = {
+  presets: [require.resolve('@docusaurus/core/lib/babel/preset')],
+};