aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorProtesilaos Stavrou <info@protesilaos.com>2022-08-23 16:22:22 +0300
committerProtesilaos Stavrou <info@protesilaos.com>2022-08-23 16:22:22 +0300
commitce6d2b7655d766bfaddc206e28cff6ae1ea947e3 (patch)
tree751a65af9d2ab5d5003d4391656412dada8b85b0
parenta4ac684e11fff98b5d0ed167f6fe0c7f3d6219cb (diff)
Expand the text of the principles
-rw-r--r--README.org18
1 files changed, 15 insertions, 3 deletions
diff --git a/README.org b/README.org
index ca84f68..f46e523 100644
--- a/README.org
+++ b/README.org
@@ -875,9 +875,10 @@ The above list is non-exhaustive though you get the idea.
:END:
+ No customization options that affect the coloration of individual
- components ! Either you like them or you don't. To change faces, it
- is better to do it in user-level configurations (report the issue and
- we can help with the relevant code). Providing customizations that
+ components! Either you like them or you don't. To change the
+ attributes of individual faces, it is better to do it in user-level
+ configurations ([[#h:152326a3-9356-4158-8adb-83c42c2ef117][Do-It-Yourself customizations]]). Report the issue and
+ we can help with the relevant code. Providing customizations that
refashion a wide set of themes is not maintainable.
+ Curated list of supported faces ([[#h:c8d80daf-d039-40c4-bb74-e7814a9b4c79][Supported packages or face groups]]).
@@ -891,6 +892,17 @@ The above list is non-exhaustive though you get the idea.
standard). Use my =modus-themes= package (also built into Emacs 28 or
higher) if you need top-class accessibility.
++ If two elements are functionally different, the theme must render this
+ fact conspicuous ([[#h:b59f315c-6d25-4225-b99b-c06594fa3bf0][Let Org tags inherit the heading color?]]).
+
++ Respect the decisions of the upstream package provider or, else, do
+ not make weird things with faces. We only override the design choice
+ of a package if it is necessary.
+
++ When there is an inescapable trade-off between usability and
+ aesthetics, we will always opt for the former, without prejudice to
+ the aforementioned principles.
+
** Minimal VS maximal scope
:PROPERTIES:
:CUSTOM_ID: h:fb219b87-ab95-401a-a742-a2fc451bf9f7