From 34f6873f6e38590a5edcfbe3ef8c1f15c22189a1 Mon Sep 17 00:00:00 2001 From: Eric Wong Date: Thu, 27 Feb 2020 13:34:51 +0000 Subject: doc: design_www: document offline friendliness This isn't anything new and has been a part of the design since the beginning, but it may not be apparent to some folks. --- Documentation/design_www.txt | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/Documentation/design_www.txt b/Documentation/design_www.txt index 240fa504..b1f916dd 100644 --- a/Documentation/design_www.txt +++ b/Documentation/design_www.txt @@ -77,6 +77,23 @@ installed to render uncommon characters. Plain text (raw message) endpoints display in the original encoding(s) of the original email. +Offline friendly +---------------- + +The "/t/", "/T/", "t.mbox.gz" endpoints are designed to be +useful for reading long threads for users with intermittent +connections or saved for offline viewing. + +Date displays are always absolute, not the "X hours ago" +pattern commonly seen because readers may be reading a +previously-saved or cached copy. + +HTML URLs end with '/' or "$FILENAME.html". The reason many +URLs end with the '/' character is so it can trivially be saved +to a directory via wget or similar tools as "index.html", making +it easy to mirror all files ending in ".html" using any static +web server. + Guidelines for using limited HTML --------------------------------- -- cgit v1.2.3-24-ge0c7