From 5ed2cf03bb309f9b2911bc863f6858edf31748a2 Mon Sep 17 00:00:00 2001 From: Idan Gazit Date: Tue, 30 Aug 2011 08:14:35 +0000 Subject: [PATCH] Added admin browser support policy note. git-svn-id: http://code.djangoproject.com/svn/django/trunk@16711 bcc190cf-cafb-0310-a4f2-bffc1f526a37 --- docs/faq/admin.txt | 12 ++++++++++++ docs/releases/1.4.txt | 19 ++++++++++++++++++- 2 files changed, 30 insertions(+), 1 deletion(-) diff --git a/docs/faq/admin.txt b/docs/faq/admin.txt index 32cea67479..a0e3b92c37 100644 --- a/docs/faq/admin.txt +++ b/docs/faq/admin.txt @@ -94,3 +94,15 @@ site is built using semantic HTML and plenty of CSS hooks, so any changes you'd like to make should be possible by editing the stylesheet. We've got a :doc:`guide to the CSS used in the admin ` to get you started. +What browsers are supported for using the admin? +------------------------------------------------ + +The admin provides a fully-functional experience to `YUI's A-grade`_ browsers, +with the notable exception of IE6, which is not supported. + +There *may* be minor stylistic differences between supported browsers—for +example, some browsers may not support rounded corners. These are considered +acceptable variations in rendering. + +.. _YUI's A-grade: http://yuilibrary.com/yui/docs/tutorials/gbs/ + diff --git a/docs/releases/1.4.txt b/docs/releases/1.4.txt index d676ff045c..49204c4f1c 100644 --- a/docs/releases/1.4.txt +++ b/docs/releases/1.4.txt @@ -57,10 +57,27 @@ HTML5 We've switched the admin and other bundled templates to use the HTML5 doctype. While Django will be careful in its use of HTML5 features, to maintain -compatibility with old browsers, this change means that you can use any HTML5 +compatibility with older browsers, this change means that you can use any HTML5 features you need in admin pages without having to lose HTML validity or override the provided templates to change the doctype. +Supported browsers for the admin +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Django hasn't had a clear policy on which browsers are supported for using the +admin app. Django's new policy formalizes existing practices: `YUI's A-grade`_ +browsers should provide a fully-functional admin experience, with the notable +exception of IE6, which is no longer supported. + +Released over ten years ago, IE6 imposes many limitations on modern web +development. The practical implications of this policy are that contributors +are free to improve the admin without consideration for these limitations. + +This new policy **has no impact** on development outside of the admin. Users of +Django are free to develop webapps compatible with any range of browsers. + +.. _YUI's A-grade: http://yuilibrary.com/yui/docs/tutorials/gbs/ + List filters in admin interface ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~