From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on dcvr.yhbt.net X-Spam-Level: X-Spam-ASN: X-Spam-Status: No, score=-4.0 required=3.0 tests=ALL_TRUSTED,BAYES_00 shortcircuit=no autolearn=ham autolearn_force=no version=3.4.2 Received: from localhost (dcvr.yhbt.net [127.0.0.1]) by dcvr.yhbt.net (Postfix) with ESMTP id 8F33C1F619 for ; Thu, 27 Feb 2020 13:34:51 +0000 (UTC) From: Eric Wong To: meta@public-inbox.org Subject: [PATCH] doc: design_www: document offline friendliness Date: Thu, 27 Feb 2020 13:34:51 +0000 Message-Id: <20200227133451.30330-1-e@80x24.org> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit List-Id: 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 --------------------------------- -- EW