chore(infra): revert to dynamic usage of Docusaurus (#2134)

.github/workflows/jekyll-gh-pages.yml

@@ -37,14 +37,22 @@ jobs:
       - run: yarn config set network-timeout 300000
       - run: yarn
       - run: yarn build
-      - run: yarn workspace engine-guides build
       - run: yarn docs build
       - name: Build with Jekyll
         uses: actions/jekyll-build-pages@v1
         with:
           source: ./_docs
           destination: ./_site
-      - run: sudo mkdir -p ./_site/guides && sudo mv ./guides/build/* ./_site/guides
+      - name: Create guides' package.json
+        # using `sudo` to avoid permissions errors
+        run: sudo mv ./.package.json ./package.json
+        working-directory: ./guides
+      - name: Install guides' dependencies
+        run: yarn && yarn build
+        working-directory: ./guides
+      - name: Move guides' output to Jekyll's `_site` in subdirectory
+        # using `sudo` to avoid permissions errors
+        run: sudo mkdir -p ./_site/guides && sudo mv ./guides/build/* ./_site/guides
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v1
 

guides/.gitignore

@@ -3,3 +3,8 @@ build
 
 # Generated files
 .docusaurus
+
+# this is a dynamic usage of Docusaurus, so dependencies are not under version control, see README.md
+package.json
+yarn.lock
+node_modules/

guides/package.json → guides/.package.json

@@ -1,6 +1,5 @@
 {
   "name": "engine-guides",
-  "version": "41.0.1",
   "private": true,
   "scripts": {
     "docusaurus": "docusaurus",

guides/README.md

@@ -4,6 +4,10 @@ This website is built using [Docusaurus 3](https://docusaurus.io/), a modern sta
 
 ## Local Development
 
+Because of issues with quality of Docusaurus dependency management, we use it dynamically, so in GitHub action
+for publishing and without committing `package.json` into repository. You should rename `.package.json` to `package.json`
+before starting local development.
+
 ```
 yarn workspace engine-guides start
 ```

package.json

@@ -4,8 +4,7 @@
     "examples/*",
     "packages/*",
     "test-fixtures/*",
-    "test-fixtures/workspace/packages/*",
-    "guides"
+    "test-fixtures/workspace/packages/*"
   ],
   "scripts": {
     "clean": "rimraf -g \"./packages/*/dist\" \"./examples/*/dist\" \"./test-fixtures/*/dist\" \"./test-fixtures/workspace/packages/*/dist\"",