[elpa] externals/ef-themes db756b7c5d 1/3: Add section about ef-themes and modus-themes diff

[ELPA Syncer]

branch: externals/ef-themes
commit db756b7c5d20a12def12906fdfb7ecf2e430dc9c
Author: Protesilaos Stavrou <info@protesilaos.com>
Commit: Protesilaos Stavrou <info@protesilaos.com>

    Add section about ef-themes and modus-themes diff
---
 README.org | 63 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 63 insertions(+)

diff --git a/README.org b/README.org
index 0e840f5f5c..2ff36b92f0 100644
--- a/README.org
+++ b/README.org
@@ -1198,6 +1198,69 @@ The =ef-themes= are my answer to those who (i) like my 
=modus-themes=,
 (ii) want something with a bit more flair, and (iii) are fine with a
 bit more relaxed accessibility target.
 
+** Difference between ef-themes and modus-themes?
+:PROPERTIES:
+:CUSTOM_ID: h:9efafe65-1a2c-4f50-88bf-885f60afe27e
+:END:
+
+The main difference between the two projects is that the
+=modus-themes= are much more strict with maintaining the highest
+standard for contrast (I won't delve into the technicalities, though
+the manual of the =modus-themes= does elaborate on the minutiae).
+Whereas the =ef-themes= do not have such a commitment: they are
+legible, but might go a bit below the desired target in certain cases.
+
+From the user who has already narrowed their search to the Modus and
+Ef themes, the criterion should be the eye test.  If any of those
+items looks good/usable, then that is what matters.  A bit of
+experimentation provides greater insight than tomes on theoretical
+nuances---no value in overthinking it.
+
+Between the =ef-themes= and the =modus-themes=, I provide a broad
+range of options for users who need varying degrees of legibility.
+The =modus-themes= are the ones with the highest contrast.
+
+I have always maintained the view that (i) there is no such thing as a
+one-size-fits-all for accessibility due to differences in colour
+perception between individuals as well as hardware capabilities, and
+(ii) no theme can handle accessibility on its own, as one needs to
+consider typography as well as environmental factors.
+
+[ For my preferred typography, check Iosevka Comfy:
+  <https://protesilaos.com/emacs/iosevka-comfy-pictures>. ]
+
+Technically, the very high contrast of the =modus-themes= demands that
+they are not---and can never be---as colourful as the =ef-themes=.
+Their colours are less saturated.  In terms of presentation, this
+means that the =modus-themes= may appear more minimalist (or "clean")
+once one gets used to their level of contrast.  In general: do not
+trust initial impressions and give the themes a fair chance (if one is
+used to low contrast settings, the =modus-themes= feel hard to get
+utsed to, though this is natural as the eye adapts accordingly).
+
+The =ef-themes= are more colourful, which can make them more/less
+pleasant to work with, depending on one's subjectivity.  Within the
+=ef-themes=, there is considerable diversity, as each of the 20 items
+has its own character, expressed as a unique colour palette and colour
+mapping.  No two themes are alike.  For example, for light themes
+~ef-summer~ gives the user a completely different vibe than
+~ef-frost~, while for dark themes ~ef-bio~ and ~ef-cherie~ each have
+their unique charm.
+
+I cannot possibly say which the "best" is.  This is a subjective
+evaluation.  For me personally, both projects are technically
+excellent in terms of conforming with their stated ends.
+Aesthetically, I like them all, which is why I develop/maintain them.
+I am not prioritising one over the other.
+
+Note that I am emphasising legibility, though this should not discount
+the meticulous work that goes into thematic consistency.  I do not
+write about this topic because it does not really matter to the
+average user.  Consistency is not something that should actively be
+calling for one's attention, though it is "there" for those who wish
+to pay attention.  In short: I am not picking random colours and
+implementing them on a whimsy.  Theme development is not easy.
+
 ** Too many options, what should I do?
 :PROPERTIES:
 :CUSTOM_ID: h:3c0201ed-2c06-4981-a3a3-3d15bc4eec00