From 31143471637ac30ea1c6ccbdecdb854bfc5be5ed Mon Sep 17 00:00:00 2001 From: Sunil Mohan Adapa Date: Thu, 17 Dec 2020 11:47:29 -0800 Subject: [PATCH] HACKING: Add suggestion not over-use Bootstrap utility classes Signed-off-by: Sunil Mohan Adapa Reviewed-by: Veiko Aasa --- HACKING.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/HACKING.md b/HACKING.md index 01398c259..5bf1edf98 100644 --- a/HACKING.md +++ b/HACKING.md @@ -483,6 +483,16 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for information how to best contribute co ## Miscelanea +### Styling + +FreedomBox uses Bootstrap as the CSS library for basic styling. However, +Bootstrap seems to encourage writing CSS within HTML by adding "utility" +classes. This is a bad practice that violates the separation of semantics from +presentation. It also leads to repetition of code that further leads to +inconsistencies. These utility classes must be used sparingly. Instead, CSS must +be written separately either for a specific page or for the entire interface +aiming for reuse. + ### Application Icons When adding a new App into FreedomBox, an icon is needed to represent the app in