about summary refs log tree commit homepage
path: root/Documentation/design_www.txt
blob: 1cd0d96ebdc72c4257fb2dc5bb99bf9ef12ea334 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
URL naming
----------

### Unstable endpoints
/$LISTNAME/?r=$GIT_COMMIT                       -> HTML only
/$LISTNAME/index.atom.xml                       -> Atom feed
/$LISTNAME/all.atom.xml                         -> Atom feed, includes replies

### Stable endpoints
/$LISTNAME/m/$MESSAGE_ID.html                   -> HTML content (short quotes)
/$LISTNAME/m/$MESSAGE_ID.txt                    -> raw original
/$LISTNAME/m/$MESSAGE_ID                        -> 301 to .html version
/$LISTNAME/f/$MESSAGE_ID.html                   -> HTML content (full quotes)
/$LISTNAME/f/$MESSAGE_ID                        -> 301 to .html version
/$LISTNAME/f/$MESSAGE_ID.txt                    -> 301 to m/$MESSAGE_ID.txt

TODO (these might be expensive)
-------------------------------
/$LISTNAME/t/$MESSAGE_ID.html                   -> HTML content of thread
/$LISTNAME/t/$MESSAGE_ID.mbox                   -> mbox content of thread

We use file name suffixes on all of these (except /) so URLs may easily
cached/memoized using a static file server.