improve WUI directory page according to a new user's first impressions

[kpreid]

I set up a Tahoe client (so I could share files with him securely) for someone who is technically knowledgeable, but does not know Tahoe's architecture. When I showed him the directory page for our shared directory, he found it uninformative, as follows:

• “The Directory page should have a Title or Label that says it is Tahoe xxx” — that is, that it is a part of Tahoe.
• “What is the difference between Upload a file and Attach a file - in a directory page?” — I think this could be improved by changing the wording of the Attach form to something like "Add a file already in Tahoe in this directory"
• “What is Mutable?” (in the upload-a-file form)

[zooko]

To close this ticket do the following three things:

• make the Title and/or Label of the Directory page say "Tahoe xxx" to indicate that it is part of Tahoe
• Change the wording of the "Attach" form to something like "Add a link into this directory pointing to a file that is already stored in Tahoe." (note: the Web user terminology of linking is superior to the operating system terminology of "putting a thing into a directory/folder" because it indicates the real structure which is made up of links, not inclusions).
• Add a hyperlink with anchor text "What is this?" next to the "mutable" check-box which explains what mutable files are and how you never want to use them. Hm, maybe this also means hide the "mutable" check-box behind some sort of expert-user-mode? :-/

Kevin Reid, who opened this ticket, also subsequently contributed some patches in #692 (improve appearance of welcome and directory pages) which change the WUI, but I don't know if any of those patches fix any of these three issues.

[zooko]

I've implemented most of this, but not yet the part about:

• Add a hyperlink with anchor text "What is this?" next to the "mutable" check-box which explains what mutable files are and how you never want to use them. Hm, maybe this also means hide the "mutable" check-box behind some sort of expert-user-mode? :-/

I haven't committed it to trunk yet, but probably will before the v1.5 release.

[zooko]

eb5ecc931d754205 fixes "* make the Title and/or Label of the Directory page indicate that it is part of TahoeLAFS", and "* Change the wording of the 'Attach' form", but not "* Add a hyperlink with anchor text "What is this?" next to the "mutable" check-box which explains what mutable files are and how you never want to use them. Hm, maybe this also means hide the "mutable" check-box behind some sort of expert-user-mode? :-/ "

[zooko]

We're not going to finish this for v1.5.