docs: tidy up website tooling and repo config

.editorconfig

@@ -12,5 +12,6 @@ quote_type = single
 [Makefile]
 indent_style = tab
 
-[{*.yaml, *.yml}]
+[{*.yaml,*.yml}]
 indent_size = 2
+quote_type = double

.github/workflows/_checks.yaml

@@ -155,7 +155,7 @@ jobs:
 
     strategy:
       matrix:
-        os: ["ubuntu-latest"]
+        os: [ubuntu-latest]
         python-version: ["3.11", "3.14"]
 
     runs-on: ${{ matrix.os }}
@@ -215,7 +215,7 @@ jobs:
 
     strategy:
       matrix:
-        os: ["ubuntu-latest"]
+        os: [ubuntu-latest]
         python-version: ["3.11", "3.14"]
 
     runs-on: ${{ matrix.os }}

.github/workflows/manual_release_beta.yaml

@@ -27,7 +27,7 @@ jobs:
         uses: apify/actions/wait-for-checks@v1.6.2
         with:
           ref: ${{ github.sha }}
-          check-regexp: '^Checks'
+          check-regexp: ^Checks
 
   release_prepare:
     name: Release prepare

.github/workflows/manual_release_docs.yaml

@@ -46,7 +46,7 @@ jobs:
         uses: apify/actions/wait-for-checks@v1.6.2
         with:
           ref: ${{ github.sha }}
-          check-regexp: '^Checks'
+          check-regexp: ^Checks
 
       - name: Checkout repository
         uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
@@ -84,8 +84,8 @@ jobs:
         uses: apify/actions/signed-commit@v1.6.2
         with:
           message: "chore: Automatic docs theme update [skip ci]"
-          add: 'website/package.json website/pnpm-lock.yaml'
-          pull: '--rebase --autostash'
+          add: website/package.json website/pnpm-lock.yaml
+          pull: --rebase --autostash
           github-token: ${{ secrets.APIFY_SERVICE_ACCOUNT_GITHUB_TOKEN }}
 
       - name: Build docs

.github/workflows/manual_release_stable.yaml

@@ -40,7 +40,7 @@ jobs:
         uses: apify/actions/wait-for-checks@v1.6.2
         with:
           ref: ${{ github.sha }}
-          check-regexp: '^Checks'
+          check-regexp: ^Checks
 
   release_prepare:
     name: Release prepare

.github/workflows/manual_version_docs.yaml

@@ -50,7 +50,7 @@ jobs:
         uses: apify/actions/wait-for-checks@v1.6.2
         with:
           ref: ${{ github.sha }}
-          check-regexp: '^Checks'
+          check-regexp: ^Checks
 
       - name: Checkout repository
         uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
@@ -131,6 +131,6 @@ jobs:
         uses: apify/actions/signed-commit@v1.6.2
         with:
           message: "docs: Version docs for v${{ steps.snapshot.outputs.version }} [skip ci]"
-          add: 'website/versioned_docs website/versioned_sidebars website/versions.json'
-          pull: '--rebase --autostash'
+          add: website/versioned_docs website/versioned_sidebars website/versions.json
+          pull: --rebase --autostash
           github-token: ${{ secrets.APIFY_SERVICE_ACCOUNT_GITHUB_TOKEN }}

.markdownlint.yaml

@@ -8,9 +8,9 @@ line-length: false
 ul-style:
   style: dash
 
-# Nested unordered lists use 4-space indentation.
-ul-indent:
-  indent: 4
+# Code blocks are fenced, never indented.
+code-block-style:
+  style: fenced
 
 # Docs are MDX and embed JSX components.
 no-inline-html: false

.rules.md

@@ -52,12 +52,12 @@ uv run poe e2e-tests
 - Unused imports are allowed in `__init__.py` files (re-exports)
 - **Pre-commit hooks**: lint check + type check run automatically on commit
 - **Commits**: [Conventional Commits](https://www.conventionalcommits.org/) format. Choose the type based on *what* changed, not just *why*:
-    - `feat:` / `fix:` / `perf:` / `refactor:` / `style:` — **source code only**; these trigger a release and appear in the changelog
-    - `test:` — test additions or changes (no release triggered)
-    - `docs:` — documentation changes; also triggers a doc release on master
-    - `ci:` — CI/workflow changes
-    - `chore:` — dependency bumps, tooling, and other housekeeping
-    - `build:` — build system changes
+  - `feat:` / `fix:` / `perf:` / `refactor:` / `style:` — **source code only**; these trigger a release and appear in the changelog
+  - `test:` — test additions or changes (no release triggered)
+  - `docs:` — documentation changes; also triggers a doc release on master
+  - `ci:` — CI/workflow changes
+  - `chore:` — dependency bumps, tooling, and other housekeeping
+  - `build:` — build system changes
 
 ### Pydantic aliases
 

CONTRIBUTING.md

@@ -122,7 +122,8 @@ uv run poe run-docs
 
 Markdown content (this guide, `README.md`, and the `docs/` folder) is checked with
 [markdownlint](https://github.com/DavidAnson/markdownlint). The Docusaurus website code is linted
-with [oxlint](https://oxc.rs/) and formatted with [oxfmt](https://oxc.rs/). All of them run in CI.
+with [oxlint](https://oxc.rs/) in type-aware mode (types come from `website/tsconfig.json`) and
+formatted with [oxfmt](https://oxc.rs/). All of them run in CI.
 To run them locally (requires Node.js 22.12 or newer and pnpm), from the `website/` directory:
 
 ```sh

docs/04_upgrading/upgrading_to_v2.md

@@ -14,9 +14,9 @@ Support for Python 3.8 has been dropped. The Apify Python SDK v2.x now requires
 
 - The SDK now uses [crawlee](https://github.com/apify/crawlee-python) for local storage emulation. This change should not affect intended usage (working with `Dataset`, `KeyValueStore` and `RequestQueue` classes from the `apify.storages` module or using the shortcuts exposed by the `Actor` class) in any way.
 - There is a difference in the `RequestQueue.add_request` method: it accepts an `apify.Request` object instead of a free-form dictionary.
-    - A quick way to migrate from dict-based arguments is to wrap it with a `Request.model_validate()` call.
-    - The preferred way is using the `Request.from_url` helper which prefills the `unique_key` and `id` attributes, or instantiating it directly, e.g., `Request(url='https://example.tld', ...)`.
-    - For simple use cases, `add_request` also accepts plain strings that contain a URL, e.g. `queue.add_request('https://example.tld')`.
+  - A quick way to migrate from dict-based arguments is to wrap it with a `Request.model_validate()` call.
+  - The preferred way is using the `Request.from_url` helper which prefills the `unique_key` and `id` attributes, or instantiating it directly, e.g., `Request(url='https://example.tld', ...)`.
+  - For simple use cases, `add_request` also accepts plain strings that contain a URL, e.g. `queue.add_request('https://example.tld')`.
 - Removing the `StorageClientManager` class is a significant change. If you need to change the storage client, use `crawlee.service_container` instead.
 
 ## Configuration

website/package.json

@@ -16,8 +16,8 @@
         "lint:fix": "pnpm lint:md:fix && pnpm lint:code:fix",
         "lint:md": "cd .. && markdownlint --config .markdownlint.yaml \"**/*.{md,mdx}\" --ignore-path .gitignore --ignore website/versioned_docs --ignore website/versioned_sidebars --ignore CHANGELOG.md --ignore docs/changelog.md",
         "lint:md:fix": "cd .. && markdownlint --fix --config .markdownlint.yaml \"**/*.{md,mdx}\" --ignore-path .gitignore --ignore website/versioned_docs --ignore website/versioned_sidebars --ignore CHANGELOG.md --ignore docs/changelog.md",
-        "lint:code": "oxlint",
-        "lint:code:fix": "oxlint --fix",
+        "lint:code": "oxlint --type-aware --deny-warnings",
+        "lint:code:fix": "oxlint --type-aware --fix",
         "format": "oxfmt",
         "format:check": "oxfmt --check",
         "opt:images": "pnx --config.onlyBuiltDependencies=* @343dev/optimizt --webp",
@@ -28,26 +28,25 @@
         "@apify/docusaurus-plugin-typedoc-api": "^5.1.16",
         "@docusaurus/core": "^3.10.2",
         "@docusaurus/faster": "^3.10.2",
-        "@docusaurus/plugin-client-redirects": "^3.10.2",
         "@docusaurus/preset-classic": "^3.10.2",
         "@signalwire/docusaurus-plugin-llms-txt": "^1.2.2",
         "clsx": "^2.1.1",
-        "docusaurus-gtm-plugin": "^0.0.2",
-        "prop-types": "^15.8.1",
         "raw-loader": "^4.0.2",
-        "react": "^19.2.8",
-        "react-dom": "^19.2.8",
+        "react": "^19.3.0",
+        "react-dom": "^19.3.0",
         "unist-util-visit": "^5.1.0"
     },
     "devDependencies": {
         "@apify/oxlint-config": "^0.3.0",
         "@apify/tsconfig": "^0.2.0",
-        "@types/react": "^19.2.18",
+        "@docusaurus/module-type-aliases": "^3.10.2",
+        "@docusaurus/types": "^3.10.2",
+        "@types/react": "^19.3.0",
         "markdownlint": "^0.41.1",
         "markdownlint-cli": "^0.49.1",
         "oxfmt": "^0.72.0",
-        "oxlint": "^1.80.0",
-        "path-browserify": "^1.0.1",
+        "oxlint": "^1.87.0",
+        "oxlint-tsgolint": "^7.0.2004",
         "rimraf": "^6.1.3",
         "typescript": "^6.0.3"
     },