public-inbox 1.1.0-pre1

[public-inbox.git] / Documentation / design_www.txt

diff --git a/Documentation/design_www.txt b/Documentation/design_www.txt
index 67a90931f84e2405ba9e0ca3dab433685fe703ae..514f8ff7d9596e3bbd10db5c21e9218c675e1118 100644 (file)
--- a/Documentation/design_www.txt
+++ b/Documentation/design_www.txt
@@ -25,7 +25,7 @@ URL and anchor naming
 
 /$INBOX/$MESSAGE_ID                    -> 301 to /$INBOX/$MESSAGE_ID/
 /$INBOX/$MESSAGE_ID/raw                -> raw mbox
-/$INBOX/$MESSAGE_ID/R/                 -> HTML reply instructions
+/$INBOX/$MESSAGE_ID/#R                 -> HTML reply instructions
 
 # Covering up a pre-1.0 design mistake:
 /$INBOX/$MESSAGE_ID/f/                 -> 301 to /$INBOX/$MESSAGE_ID/
@@ -76,10 +76,9 @@ browsers default to.
 * No graphics, images, or icons at all.  We tolerate, but do not
   encourage the use of GUIs.
 
-* No setting colors or font sizes, power to users to decide those.
+* No setting font sizes, power to users to decide those.
   We will include and document <span class=?> to support colors
-  for user-supplied CSS, and may support client-supplied CSS
-  via cookie.
+  for user-supplied CSS.
 
 * Only one font type: fixed.  This is for accessibility, we must
   not blow certain elements out-of-proportion with different
@@ -99,15 +98,17 @@ browsers default to.
 * We only use CSS for one reason: wrapping pre-formatted text
   This is necessary because unfortunate GUI browsers tend to be
   prone to layout widening from unwrapped mailers.
-  w3m is fine here without CSS :)
-  No other CSS is allowed, especially with scary things like:
+  Do not expect CSS to be enabled, especially with scary things like:
 
-       http://thejh.net/misc/website-terminal-copy-paste
+       https://thejh.net/misc/website-terminal-copy-paste
 
   However, we will try to make it easy for users to supply their
-  own colors and perhaps offer color options over cookies.
+  own colors via user-side CSS.
 
 CSS classes (for user-supplied CSS)
 -----------------------------------
 span.q - quoted text in email messages
+
+TODO: consider using highlight(1) via libhighlight-perl in Debian,
+      optionally
 ...