id	summary	reporter	owner	description	type	status	priority	milestone	component	version	resolution	keywords	cc	launchpad_bug
1866	Clarify url syntax at WAPI doc	thedod	marlowe	"At [https://tahoe-lafs.org/trac/tahoe-lafs/browser/git/docs/frontends/webapi.rst the WAPI doc] there should be a list of of all prefix options, followed by a list of sections describing each.

/cap appears as an orphan line somewhere on the page, and it's not clear from the text whether we should use it and when.

/file appears inside the /named section, and
theres's also no mention of the variant that contains a /@@named=/ component (the WAPI links to such urls).
What does it mean (removing the component doesn't seem to matter)? Which of the 3 options (/named/ or /file/ with or without /@@named=/) is preferred when?

Another thing I can't find (maybe it's on some other doc, but then webapi.rst should link to it): list (+ explanation) of all cap types: DIR2-RO, DIR2-CHK, CHK, etc. (and in general - explanation of cap uri syntax).
This (or a link to it) should appear before explaining urls that *contain* a cap :)
"	defect	closed	normal	undecided	documentation	1.9.2	duplicate	webapi docs