Skip to content

[documentation] Carry-through status table contradicts shipped code; document remaining gapsΒ #668

@MartinCastroAlvarez

Description

@MartinCastroAlvarez

Audit 2026-06-02 β€” docs/parity (Medium)

The README "carry-through status" table is stale vs the shipped code:

  • README marks raw_id_fields / radio_fields 🟑 and claims raw_id falls back to autocomplete and filter_horizontal renders a checkbox list β€” but frontend/packages/form/src/FieldInput.tsx renders the pk-input+lookup, a radio bank, and ShuttleSelect today. Flip those rows to βœ….

Also add the genuinely-missing items to a "does NOT carry through" section so the parity claim stays honest:

  • empty_value_display hard-coded to β€” (format.ts:10), ignoring per-ModelAdmin/field overrides.
  • Custom AdminSite.each_context extras never reach the SPA (only a fixed set of site attrs is read in views.py).
  • list_select_related undocumented.

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationparityDjango admin parity gap (tracked in #147)

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions