apca-introduction

commit

48bf496337e858ae0cdd9f57447874d82913387f

parent

770b18db0838d86372d169b09845846be3022d4d

Author

Tobias Bengfort <tobias.bengfort@posteo.de>

Date

2025-03-21 08:19

README: rephrase criticism

Diffstat

1 files changed, 8 insertions, 5 deletions

diff --git a/README.md b/README.md

@@ -97,11 +97,14 @@ For one it was born out of my personal frustration with the original
   97    97 documentation. Some important pieces of information (e.g. the actual algorithm)
   98    98 get buried under all that text.
   99    99 
  100    -1 The original documentation also contains absolute statements like "APCA is
  101    -1 perceptually uniform" and that the old algorithm produces "invalid results".
  102    -1 This in my opinion is wrong as perceptual uniformity is an ideal that can never
  103    -1 be reached completely. So I felt like there was room for a more balanced
  104    -1 introduction.
   -1   100 It also contains a lot of misleading statements. For example, it claims that
   -1   101 the WCAG 2.x algorithm is not based on human perception (which it is) and that
   -1   102 it produces "invalid results", which the author only substantiates by anecdotal
   -1   103 evidence. So I felt like there was room for a more balanced introduction.
   -1   104 
   -1   105 Also, contributing upstream fixes is not an option because the author is
   -1   106 hostile to a cricitcal examination of their work. You can find ample evidence
   -1   107 of their behavior in the issue tracker of this repo.
  105   108 
  106   109 If you want to dig deeper, I recommend to start with the [original WCAG
  107   110 issue](https://github.com/w3c/wcag/issues/695) and the [documentation