Reorder template tag documentation.
|Reported by:||jonathanslenders||Owned by:||danielr|
|Has patch:||yes||Needs documentation:||no|
|Needs tests:||no||Patch needs improvement:||no|
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.)
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.
See this ticket #20434 for related info.
Change History (8)
comment:1 Changed 3 years ago by aaugustin
- Needs documentation unset
- Needs tests unset
- Patch needs improvement unset
- Triage Stage changed from Unreviewed to Accepted
- Version set to master
comment:3 Changed 3 years ago by danielquinn
- Owner changed from nobody to danielquinn
- Status changed from new to assigned
comment:5 Changed 3 years ago by timo
- Cc timograham@… added
- Has patch set
- Patch needs improvement set