chore(docs): generate api docs (#277)

Author: ijemmy

.github/workflows/on-docs-change.yml

@@ -6,6 +6,7 @@ on:
       - main
     paths:
       - 'docs/**'
+      - 'README.md'
       - 'CHANGELOG.md'
       - 'mkdocs.yml'
       - '.github/workflows/on-docs-change.yml'
@@ -20,25 +21,35 @@ jobs:
       - name: Set up Python
         uses: actions/[email protected]
         with:
-          python-version: "3.8"
+          python-version: '3.8'
+      - name: Set up NodeJS
+        uses: actions/setup-node@v2
+        with:
+          node-version: '17.2'
       - name: Install dependencies
         run: |
           pip install --upgrade pip 
           pip install mike==1.1.2 mkdocs-material==8.0.5 mkdocs-git-revision-date-plugin==0.3.1
+          npm ci
       - name: Setup doc deploy
         run: |
           git config --global user.name Docs deploy
           git config --global user.email [email protected]
-      - name: Build docs website and (TODO) API reference 
+      - name: Build mkdocs site in 'gh-pages' branch and push
         run: |
+          rm -rf site
           VERSION="develop"
           ALIAS="stage"
           mkdocs build
           mike deploy --push --update-aliases "$VERSION" "$ALIAS"
-      - name: Deploy all docs
+      - name: Build API documentation site 
+        run: |
+          rm -rf api
+          npm run docs-generateApiDoc
+      - name: Deploy API documentation site (copy to "gh-pages" branch inside the version folder)
         uses: peaceiris/actions-gh-pages@v3
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
-          publish_dir: ./site
+          publish_dir: ./api
           keep_files: true
           destination_dir: develop/api 

.gitignore

@@ -35,4 +35,7 @@ coverage
 venv
 
 # Static documentation site generated by Mkdocs
-site
+site
+
+# Generated API documentation (from TypeDoc)
+/api