From a14829ac88d183d48e4f91a18509a41ce6d29bb8 Mon Sep 17 00:00:00 2001 From: Henrik Levkowetz Date: Sat, 18 Jul 2015 09:30:54 +0000 Subject: [PATCH] Merged in [9736] from lars@netapp.com: Update the README now that the facelift has happened, and remove the outdated TODO. - Legacy-Id: 9770 Note: SVN reference [9736] has been migrated to Git commit fbf30230d1f00839a28e5a28d6c6d04952103c1b --- README | 25 ------------------------- README.datatracker | 35 +++++++++++++++++++++++++++++++++++ TODO | 11 ----------- 3 files changed, 35 insertions(+), 36 deletions(-) delete mode 100644 README create mode 100644 README.datatracker delete mode 100644 TODO diff --git a/README b/README deleted file mode 100644 index 18bdec71f..000000000 --- a/README +++ /dev/null @@ -1,25 +0,0 @@ -This is the "facelift" datatracker branch that uses Twitter Bootstrap for -the UI. - -You need to install a few new django extensions: - https://pypi.python.org/pypi/django-widget-tweaks - https://pypi.python.org/pypi/django-bootstrap3 - https://pypi.python.org/pypi/django-typogrify - -The meta goal of this effort is: *** NO CHANGES TO THE PYTHON CODE *** - -Whenever changes to the python code are made, they can only fix HTML bugs, -or add comments (tagged with "FACELIFT") about functionality that can be -removed once the facelift templates become default. Or they need to add -functionality that is only called from the new facelift templates. - -Javascript that is only used on one template goes into that template. -Javascript that is used by more than one template goes into ietf.js. - -CSS that is only used on one template goes into that template. -CSS that is used by more than one template goes into ietf.css. No CSS in the -templates or - god forbid - style tags! (And no CSS or HTML styling in -python code!!) - -Templates that use jquery or bootstrap plugins include the css in the pagehead -block, and the js in the js block. diff --git a/README.datatracker b/README.datatracker new file mode 100644 index 000000000..bd429ee4b --- /dev/null +++ b/README.datatracker @@ -0,0 +1,35 @@ +The "new" datatracker uses Twitter Bootstrap for the UI. + +Get familiar with http://getbootstrap.com/getting-started/ and use those +UI elements instead of cooking up your own. + +We have some site-wide customization applied to the bootstrap version we keep +in bootstrap/ (from which the minified dist version is built); it modifies +some stuff under less/ + +We also apply some additional custiomizations in static/css/ietf.css; we +should eventually move that under bootstrap/less/ if possible. (ietf.css was +what Lars used initially for customization with an unmodified bootstrap.) + +Some ground rules: + +* Think hard before tweaking the bootstrap CSS, it will make it harder to + upgrade to future releases. + +* No