Audit docs against code: fix inaccuracies found in review

- dashboard-widgets: add missing WidgetActionChartProps import to example
- form-widgets: clarify PasswordInput auto change_password is create-only
- authentication: authenticate must return int or UUID, not str
- model-admins: describe save_as_continue default (changelist redirect)
- quickstart: note the bcrypt example field names are illustrative
- contributing/index: replace stale mypy references with ty
- Makefile: build docs social cards only in CI (needs Cairo system libs)

Author: vsdudakov

Makefile

@@ -34,9 +34,10 @@ test:
 cov: test
 
 # --- Documentation (MkDocs Material) -----------------------------------------
-# Build the static site into ./site (social cards enabled, like CI).
+# Build the static site into ./site. Social cards are generated only in CI
+# (the docs workflow installs the Cairo system libraries they need).
 docs:
-	CI=true uv run --group docs mkdocs build --strict
+	uv run --group docs mkdocs build --strict
 
 # Live-preview at http://127.0.0.1:8000 (social cards off for speed).
 docs-serve:

docs/contributing.md

@@ -33,7 +33,7 @@ make dev        # uv sync --all-extras + frontend yarn install
 
 | Command | What it does |
 | --- | --- |
-| `make lint` | ruff check + ruff format --check + mypy, then the frontend linters. |
+| `make lint` | ruff check + ruff format --check + ty, then the frontend linters. |
 | `make format` | Auto-fix lint issues and reformat (Python + frontend). |
 | `make test` | Backend tests with a **100% coverage gate**, then frontend tests. |
 | `make build` | Build the frontend into `fastadmin/static` and the wheel/sdist via `uv build`. |

docs/getting-started/quickstart.md

@@ -93,6 +93,11 @@ class UserAdmin(TortoiseModelAdmin):
     (and `change_password` if you want password editing). See
     [Authentication](../guides/authentication.md).
 
+!!! note
+
+    Adapt the field names (`hash_password`, `is_active`, …) to your own user
+    model — the snippet above shows the recommended bcrypt-hashed setup.
+
 ## 3. Run it
 
 Start your app as usual (e.g. `uvicorn example:app` for FastAPI) and open

docs/guides/authentication.md

@@ -43,7 +43,7 @@ class UserAdmin(TortoiseModelAdmin):
 
 - `authenticate(username, password)` receives the value of the
   `ADMIN_USER_MODEL_USERNAME_FIELD` field and the password, and returns a user
-  id (`int`, `str` or `UUID`) or `None`.
+  id (`int` or `UUID`) or `None`.
 - `change_password(id, password)` stores a new password. FastAdmin also calls
   it automatically after creating an object whose form contains a
   `PasswordInput` widget, so passwords are stored hashed.

docs/guides/dashboard-widgets.md

@@ -103,6 +103,7 @@ with a list of data rows:
 
 ```python
 from fastadmin import (
+    WidgetActionChartProps,
     WidgetActionFilter,
     WidgetActionInputSchema,
     WidgetActionResponseSchema,

docs/guides/form-widgets.md

@@ -18,7 +18,7 @@ components. Every widget type is available via the `WidgetType` enum:
 | `EmailInput` | Email input |
 | `PhoneInput` | Phone input with country codes |
 | `UrlInput` | URL input |
-| `PasswordInput` | Password input (values are stored via `change_password`) |
+| `PasswordInput` | Password input (on create, the value is stored via `change_password`) |
 | `TextArea` | Multi-line text |
 | `RichTextArea` | Rich-text (WYSIWYG) editor |
 | `JsonTextArea` | JSON editor |

docs/guides/model-admins.md

@@ -43,7 +43,7 @@ attributes are optional and mirror Django Admin where possible.
 | `radio_fields` | `()` | Use radio buttons instead of a select for FK/choice fields. |
 | `raw_id_fields` | `()` | Use a plain input instead of a select for FK/M2M fields. |
 | `save_as` | `False` | Replace "Save and add another" with "Save as new". |
-| `save_as_continue` | `False` | Redirect to the change view after "Save as new". |
+| `save_as_continue` | `False` | Where "Save as new" redirects: the changelist by default, or the new object's change view when `True`. |
 | `save_on_top` | `False` | Show save buttons at the top of the form too. |
 | `view_on_site` | `None` | URL for a "View on site" link. |
 | `inlines` | `()` | Inline admin classes — see [Inline admins](inline-admins.md). |

docs/index.md

@@ -61,7 +61,7 @@ app.mount("/admin", admin_app)
   (line, area, column, bar, pie) with filters, powered by antd charts.
 - :outbox_tray: **Uploads & exports** — file/image upload widgets with
   custom storage hooks, CSV/JSON export out of the box.
-- :test_tube: **Quality** — fully linted (ruff), typed (mypy) and tested with
+- :test_tube: **Quality** — fully linted (ruff), typed (ty) and tested with
   100% backend coverage.
 
 ## Explore the docs