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
20435	Reorder template tag documentation.	jonathanslenders	Daniel Roseman	"Right now, the documentation for creation of custom template tags, using a (parser, token)-function, is mentioned above the creation of simple template tags.
It would be great to revert this order, and make clear that when possible a simple tag is recommended. (Not only for readability.)

Why?:
The ability of creating custom template tags using (parser, token) is great, but it's a lot harder or impossible to predict the behaviour or the change the template render engine if we ever have to in the future. Making sure that people are using as much as possible the built-in Node classes, would do for a nice abstract syntax tree in moste cases.

https://docs.djangoproject.com/en/dev/howto/custom-template-tags/

See this ticket #20434 for related info."	Cleanup/optimization	closed	Documentation	dev	Normal	fixed		timograham@…	Accepted	1	0	0	0	0	0