From 4c5455d25ccd3b6227c8f3e58406b12a1fb703c7 Mon Sep 17 00:00:00 2001
From: Clifford Gama <53076065+cliff688@users.noreply.github.com>
Date: Wed, 13 Nov 2024 20:14:16 +0200
Subject: [PATCH] [5.1.x] Fixed #35843 -- Clarified formset docs about
 reordering forms.

Backport of 299b072498b23d1d7fe9f1545f7b27b73ca8e22b from main.
---
 docs/topics/forms/formsets.txt | 11 ++++-------
 1 file changed, 4 insertions(+), 7 deletions(-)

diff --git a/docs/topics/forms/formsets.txt b/docs/topics/forms/formsets.txt
index 1f49044e6e..3b68ed614c 100644
--- a/docs/topics/forms/formsets.txt
+++ b/docs/topics/forms/formsets.txt
@@ -48,13 +48,10 @@ following example will create a formset class to display two blank forms:
 
     >>> ArticleFormSet = formset_factory(ArticleForm, extra=2)
 
-Iterating over a formset will render the forms in the order they were
-created. You can change this order by providing an alternate implementation for
-the ``__iter__()`` method.
-
-Formsets can also be indexed into, which returns the corresponding form. If you
-override ``__iter__``, you will need to also override ``__getitem__`` to have
-matching behavior.
+Formsets can be iterated and indexed, accessing forms in the order they were
+created. You can reorder the forms by overriding the default
+:py:meth:`iteration <object.__iter__>` and
+:py:meth:`indexing <object.__getitem__>` behavior if needed.
 
 .. _formsets-initial-data: