warner/tahoe-lafs — comment on commit 6a71c901a842991542c5af5fd1497acf76f80b8a
File: src/allmydata/test/test_web.py line 2128
By warner:

this test is doing `POST /uri?t=upload`, which is the WUI (user-oriented, reached via the "Upload a File" form on the welcome page). Those docs are for `PUT /uri` (or some other PUT variants, no `t=` modifier), which is the WAPI (machine-oriented, like the CLI tools).

The machine-oriented forms should always return just the filecap.. that's all they realy care about. (I could imagine having them return a JSONified form of the upload results, but for now all they want is the filecap). The human-oriented forms (t=upload) benefit from having more information.

(having the docs split between human-oriented and machine-oriented APIs, especially when those APIs overlap a bit, can be a bit frustrating. It'd probably be a good idea to build an index of methods, with links back into the sections that describe them. Not sure how to do that in ReST, though)