id	summary	reporter	owner	description	type	status	component	version	severity	resolution	keywords	cc	stage	has_patch	needs_docs	needs_tests	needs_better_patch	easy	ui_ux
7863	"Documentation fix: Stress that template tag ""regroup"" needs a sorted list"	jedie	nobody	"[http://www.djangoproject.com/documentation/templates/#regroup regroup] does only a right job, if the list is sorted with the key for the grouping?!?


Example:
Source data:
{{{
people = [
    {'first_name': 'George', 'last_name': 'Bush', 'gender': 'Male'},
    {'first_name': 'Pat', 'last_name': 'Smith2', 'gender': 'Unknown'},
    {'first_name': 'Condoleezza', 'last_name': 'Rice', 'gender': 'Female'},
    {'first_name': 'Bill', 'last_name': 'Clinton', 'gender': 'Male'},
    {'first_name': 'Pat', 'last_name': 'Smith', 'gender': 'Unknown'},
    {'first_name': 'Margaret', 'last_name': 'Thatcher', 'gender': 'Female'},
]
}}}
Template tag:
{{{
{% regroup people by gender as grouped %}
}}}

Result:
{{{
 u'grouped': [{'grouper': 'Male',
                     'list': [{'first_name': 'George',
                               'gender': 'Male',
                               'last_name': 'Bush'}]},
                    {'grouper': 'Unknown',
                     'list': [{'first_name': 'Pat',
                               'gender': 'Unknown',
                               'last_name': 'Smith2'}]},
                    {'grouper': 'Female',
                     'list': [{'first_name': 'Condoleezza',
                               'gender': 'Female',
                               'last_name': 'Rice'}]},
                    {'grouper': 'Male',
                     'list': [{'first_name': 'Bill',
                               'gender': 'Male',
                               'last_name': 'Clinton'}]},
                    {'grouper': 'Unknown',
                     'list': [{'first_name': 'Pat',
                               'gender': 'Unknown',
                               'last_name': 'Smith'}]},
                    {'grouper': 'Female',
                     'list': [{'first_name': 'Margaret',
                               'gender': 'Female',
                               'last_name': 'Thatcher'}]}]}
}}}

work a round, using sorted, e.g:
{{{
people = sorted(people, key=lambda x: x['gender'])
}}}"		closed	Documentation	dev		worksforme		django@…	Ready for checkin	1	0	0	0	0	0