• 
      

    Fix a problem building API docs on Django 5.2.

    Review Request #14858 — Created Feb. 26, 2026 and submitted

    Information

    Review Board
    master

    Reviewers

    Django 5.x changed the vary_on_headers decorator to work slightly
    differently (internally), which exposed a problem inside the API docs
    sphinx extension. We were calling resources with the request as a kwarg,
    but WebAPIResource.__call__ explicitly lists the request as a
    positional argument. With the new decorator implementation, this was
    causing an error about a duplicate 'request' parameter.

    Built docs.

    Summary ID
    Fix a problem building API docs on Django 5.2.
    Django 5.x changed the `vary_on_headers` decorator to work slightly differently (internally), which exposed a problem inside the API docs sphinx extension. We were calling resources with the request as a kwarg, but `WebAPIResource.__call__` explicitly lists the request as a positional argument. With the new decorator implementation, this was causing an error about a duplicate 'request' parameter. Testing Done: Built docs.
    oypmrkouuqpwltuxztmyupkwmwrwmxrz
    maubin
    1. Ship It!
    2. 
        
    david
    Review request changed
    Status:
    Completed
    Change Summary:
    Pushed to master (4ffd1a7)