I like having that note but the heading isn’t super clear to me.

Do you have suggestions for a clearer title?

This can be a warning without a title

Make sense to me. I removed the title, and updated the commit.

This can be a warning without a title

@sarahboyce I just find out that the admonition directive require a title :)

...writing-documentation.txt:196: ERROR: Error in "admonition" directive:
1 argument(s) required, 0 supplied.

So I added a tittle again in the code because the use of the note directive is discouraged in the same documents.

To improve readability, use .. admonition:: Descriptive title rather tha .. note::

See https://docs.djangoproject.com/en/stable/internals/contributing/writing-documentation/#guidelines-for-restructuredtext-files

I like having that note but the heading isn’t super clear to me.

@thibaudcolas I tried to add a clearer title

I think warnings can have no title (.. warning::)

I think warnings can have no title (.. warning::)

Using .. warning:: seems a good idea, thanks, I checked that it's widely used in the code. I just updated the PR. Thanks.