Ich frage mal ganz ketzerisch: was möchtest du? Eine brauchbare Dokumentation oder ein wunderschönes semantisches Kunstwerk für Quelltext-Liebhaber?
Als ich vor 13 Jahren oder so beim ersten mit SELFHTML rumwurschtelte, fand ich das recht beeindruckend, dass das Dokument die Techniken verwendete, die es beschrieb. Allerdings las ich damals wohl auch GEB und war in der Hinsicht gerade leicht zu beeindrucken. Dass ich SELFHTMLs Quelltext und Stylesheet so einfach inspizieren und verändern konnte – das hat damals geholfen.