blocktranslate count plural example does not work for all languages (e.g. French 0 case)

[Sarah Boyce]

​https://docs.djangoproject.com/en/5.2/topics/i18n/translation/#blocktranslate-template-tag

In the blocktranslate docs, there is the following example:

{% blocktranslate count counter=list|length %}
There is only one {{ name }} object.
{% plural %}
There are {{ counter }} {{ name }} objects.
{% endblocktranslate %}

If list can be empty, the 0 case (which is plural in English) is not plural in all languages. 0 cats, 1 cat, 2 cats, 3 cats is 0 chat, 1 chat, 2 chats, 3 chats in French (notice that 0 is singular).
This means that the 0 case would say the French translation of There is only one {{ name }} object. as 0 is singular in French (and this would be a bug).

I believe the example should be updated to something like:

{% blocktranslate count counter=list|length %}
There is {{ counter }} {{ name }} object.
{% plural %}
There are {{ counter }} {{ name }} objects.
{% endblocktranslate %}

which would not lead to this issue.

Optionally we could add an admonition about plurals in different languages and that folks shouldn't assume that pluralization works the same as in English

[Jacob Walls]

Well spotted, Sarah!

[Varun Kasyap Pentamaraju]

I would like to work on this

[Varun Kasyap Pentamaraju]

Created PR ​https://github.com/django/django/pull/19994

[Varun Kasyap Pentamaraju]

PR: ​https://github.com/django/django/pull/19994

Patch:
1)used admonition instead of note
2)removed the non–Django/Python-related explanations
3) removed comma in "e.g."

[Jacob Walls <jacobtylerwalls@…>]

In 0ea0110:

Fixed #36681 -- Removed English pluralization bias from example in docs/topics/i18n/translation.txt.

[Jacob Walls <jacobtylerwalls@…>]

In f13e6c90:

[6.0.x] Fixed #36681 -- Removed English pluralization bias from example in docs/topics/i18n/translation.txt.

Backport of 0ea01101c3a35568bc43e9707ac058b9874bd425 from main.

[Jacob Walls <jacobtylerwalls@…>]

In 368f955:

[5.2.x] Fixed #36681 -- Removed English pluralization bias from example in docs/topics/i18n/translation.txt.

Backport of 0ea01101c3a35568bc43e9707ac058b9874bd425 from main.