docs: tidy up website tooling and repo config (#1181)

Website tooling and repo config cleanup, same as crawlee-python#2327 and
apify-client-python#1126.

- Website code is linted with type-aware oxlint (new
`website/tsconfig.json`), and warnings fail CI. Fixed the few issues it
found.
- Removed unused website deps and aligned version ranges with the
lockfile.
- YAML: 2-space indent, no quotes unless needed, double quotes when they
are.
- markdownlint: default 2-space list indent (as in apify-docs) and
fenced code blocks only.
- Fixed the `.editorconfig` YAML glob.

*✍️ Drafted by Claude Code*

Author: vdusek

.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