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
18110	Improve template cache tag documentation	Julian Bez	nobody	"For me it was not clear that the fragment name cannot be a variable. I just found out by wondering about errors and having a quick look into Django's code. It should be made more clear that the second argument will not be resolved even though ''all'' the others will be (even the cache time gets resolved).

""It takes at least two arguments: the cache timeout, in seconds, and the name to give the cache fragment. For example:""

should at least be something like

""It takes at least two arguments: the cache timeout, in seconds, and the name to give the cache fragment. The name will be taken as is, do not use a variable. For example:""

https://docs.djangoproject.com/en/dev/topics/cache/#template-fragment-caching"	Cleanup/optimization	closed	Documentation	dev	Normal	fixed		florian+django@…	Ready for checkin	0	0	0	0	0	0