about summary refs log tree commit homepage
path: root/Documentation/design_www.txt
diff options
context:
space:
mode:
authorEric Wong <e@80x24.org>2016-02-07 08:35:29 +0000
committerEric Wong <e@80x24.org>2016-02-07 08:46:37 +0000
commit0af0bd903b9b5aede71155ce8756e01a229b40bb (patch)
tree0b41dd9fa5540c89b3bff8f6af9b5e06721bb56c /Documentation/design_www.txt
parente31f5bf979f8316cd6156410357026b3df392f81 (diff)
downloadpublic-inbox-0af0bd903b9b5aede71155ce8756e01a229b40bb.tar.gz
This requires POST and (small file) upload support from the
PSGI/Plack web server.  CGI.pm is currently not supported with
this feature.

We'll serve everything git can handle by default for performance
in the general case.

To avoid introducing cognitive overhead for sysadmins managing
existing HTTP backends, we do not introduce new configuration
directives.

Thus, setting http.uploadpack=false in the relevant git config
file for each public-inbox (ssoma) git repo will disable smart
HTTP for CPU/memory-constrained systems.

Technically we could support http.receivepack to allow posting
messages to a public-inbox over HTTP(S), but that breaks
the public-inbox model of encouraging users to Cc: everyone.
Again, we encourage users to Cc: everyone to reduce the chance
of a public-inbox becoming a centralized point of
failure/censorship.
Diffstat (limited to 'Documentation/design_www.txt')
-rw-r--r--Documentation/design_www.txt2
1 files changed, 2 insertions, 0 deletions
diff --git a/Documentation/design_www.txt b/Documentation/design_www.txt
index 76015233..39b12414 100644
--- a/Documentation/design_www.txt
+++ b/Documentation/design_www.txt
@@ -25,6 +25,8 @@ URL naming
 
 /$LISTNAME/atom.xml [2]                   -> identical to /$LISTNAME/new.atom
 
+Additionally, we support "git clone" pointed to http://$HOST/$LISTNAME
+
 FIXME: we must refactor/cleanup/add tests for most of our CGI before
 adding more endpoints and features.