← Back to branch summary

~ubuntu-branches/debian/sid/python-django/sid

« back to all changes in this revision

Viewing changes to docs/misc/design-philosophies.txt

  • Committer: Package Import Robot
  • Author(s): Raphaël Hertzog
  • Date: 2014-09-17 14:15:11 UTC
  • mfrom: (1.3.17) (6.2.18 experimental)
  • Revision ID: package-import@ubuntu.com-20140917141511-icneokthe9ww5sk4
Tags: 1.7-2
* Release to unstable.
* Add a migrate-south sample script to help users apply their South
  migrations. Thanks to Brian May.

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/misc/design-philosophies.txt
67
67
    The `discussion of DRY on the Portland Pattern Repository`__
68
68
 
69
69
    __ http://c2.com/cgi/wiki?DontRepeatYourself
70
 
    
 
70
 
71
71
.. _explicit-is-better-than-implicit:
72
72
 
73
73
Explicit is better than implicit
307
307
 
308
308
GET and POST are distinct; developers should explicitly use one or the other.
309
309
The framework should make it easy to distinguish between GET and POST data.
 
310
 
 
311
.. _cache-design-philosophy:
 
312
 
 
313
Cache Framework
 
314
===============
 
315
 
 
316
The core goals of Django's :doc:`cache framework </topics/cache>` are:
 
317
 
 
318
Less code
 
319
---------
 
320
 
 
321
A cache should be as fast as possible.  Hence, all framework code surrounding
 
322
the cache backend should be kept to the absolute minimum, especially for
 
323
``get()`` operations.
 
324
 
 
325
Consistency
 
326
-----------
 
327
 
 
328
The cache API should provide a consistent interface across the different
 
329
cache backends.
 
330
 
 
331
Extensibility
 
332
-------------
 
333
 
 
334
The cache API should be extensible at the application level based on the
 
335
developer's needs (for example, see :ref:`cache_key_transformation`).