Changeset 2759
- Timestamp:
- 04/27/06 22:54:24 (2 years ago)
- Files:
Legend:
- Unmodified
- Added
- Removed
- Modified
- Copied
- Moved
django/branches/magic-removal/docs/design_philosophies.txt
r1218 r2759 21 21 template system a programmer uses. 22 22 23 Although Django comes with a full stack for convenience, the pieces of the 24 stack are independent of another wherever possible. 25 23 26 .. _`loose coupling and tight cohesion`: http://c2.com/cgi/wiki?CouplingAndCohesion 24 27 … … 50 53 51 54 This, a `core Python principle`_, means Django shouldn't do too much "magic." 52 Magic shouldn't happen unless there's a really good reason for it. 55 Magic shouldn't happen unless there's a really good reason for it. Magic is 56 worth using only if it creates a huge convenience unattainable in other ways, 57 and it isn't implemented in a way that confuses developers who are trying to 58 learn how to use the feature. 53 59 54 60 .. _`core Python principle`: http://www.python.org/doc/Humor.html#zen … … 97 103 framework saving things behind the scenes silently. 98 104 99 This is also why the ``select_related`` argument exists. It's an optional 100 performance booster for the common case of selecting "every related object." 105 This is also why the ``select_related()`` ``QuerySet`` method exists. It's an 106 optional performance booster for the common case of selecting "every related 107 object." 101 108 102 109 Terse, powerful syntax … … 144 151 145 152 File extensions in Web-page URLs should be avoided. 153 154 Vignette-style commas in URLs deserve severe punishment. 146 155 147 156 Definitive URLs … … 186 195 should be equally good at generating other text-based formats, or just plain 187 196 text. 197 198 XML should not be used for template languages 199 --------------------------------------------- 200 201 Using an XML engine to parse templates introduces a whole new world of human 202 error in editing templates -- and incurs an unacceptable level of overhead in 203 template processing. 188 204 189 205 Assume designer competence
