docs: Migrate from npm to yarn and relax web dependencies (#584)

- Migrate from `npm` to `yarn` for consistency.
- Same setup as in Crawlee.
- All 3 Python documentation projects (`crawlee-python`,
`apify-sdk-python`, `apify-client-python`) now use an identical yarn
setup.
- Relax website dependency constraints to reduce the number of
unnecessary Renovate PRs.
- Switch GitHub Actions to major-version tags for the same reason (only
typos, for actionlint it isn't possible, unfortunately).

Author: vdusek

.github/workflows/_check_code.yaml

@@ -24,7 +24,7 @@ jobs:
       - name: Checkout repository
         uses: actions/checkout@v6
       - name: Check spelling with typos
-        uses: crate-ci/typos@v1.42.1
+        uses: crate-ci/typos@v1
 
   lint_check:
     name: Lint check

.github/workflows/_release_docs.yaml

@@ -38,24 +38,6 @@ jobs:
         uses: actions/setup-node@v6
         with:
           node-version: ${{ env.NODE_VERSION }}
-          cache: npm
-          cache-dependency-path: website/package-lock.json
-
-      - name: Install Node dependencies
-        run: |
-          npm install
-          npm update @apify/docs-theme
-        working-directory: ./website
-
-      # We do this as early as possible to prevent conflicts if someone else would push something in the meantime
-      - name: Commit the updated package.json and lockfile
-        run: |
-          git config user.name 'GitHub Actions'
-          git config user.email 'github-actions[bot]@users.noreply.github.com'
-          git add website/package.json
-          git add website/package-lock.json
-          git diff-index --quiet HEAD || git commit -m 'chore: Automatic docs theme update [skip ci]' || true
-          git push
 
       - name: Set up Python
         uses: actions/setup-python@v6
@@ -70,6 +52,18 @@ jobs:
       - name: Install Python dependencies
         run: uv run poe install-dev
 
+      - name: Update docs theme
+        run: uv run poe update-docs-theme
+
+      - name: Commit the updated package.json and lockfile
+        run: |
+          git config user.name 'GitHub Actions'
+          git config user.email 'github-actions[bot]@users.noreply.github.com'
+          git add website/package.json
+          git add website/yarn.lock
+          git diff-index --quiet HEAD || git commit -m 'chore: Automatic docs theme update [skip ci]' || true
+          git push
+
       - name: Build docs
         run: uv run poe build-docs
         env:

pyproject.toml

@@ -204,10 +204,14 @@ shell = "uv run ruff format --check && uv run ruff check"
 [tool.poe.tasks.format]
 shell = "uv run ruff check --fix && uv run ruff format"
 
+[tool.poe.tasks.update-docs-theme]
+shell = "corepack enable && yarn up @apify/docs-theme"
+cwd = "website"
+
 [tool.poe.tasks.build-docs]
-shell = "./build_api_reference.sh && npm ci && npm run build"
+shell = "./build_api_reference.sh && corepack enable && yarn && uv run yarn build"
 cwd = "website"
 
 [tool.poe.tasks.run-docs]
-shell = "./build_api_reference.sh && npm ci && npm run start"
+shell = "./build_api_reference.sh && corepack enable && yarn && uv run yarn start"
 cwd = "website"

website/.yarnrc.yml

@@ -0,0 +1,2 @@
+nodeLinker: node-modules
+enableGlobalCache: true