Manual-writing is instructive

[jducoeur]

There's nothing like trying to write a tutorial to show you where your system is still too complicated. I'm currently writing up "Querki for the Impatient", a reasonably flying introduction to the system, and am finding myself adding simplifying enhancements to the to-do list as I go. (The Name vs. Display Name dichotomy *clearly* needs reworking...)

Comments

[juan-gandhi.livejournal.com]

How about custom dictionaries?

[mindways]

The Name vs. Display Name dichotomy *clearly* needs reworking...

Display Name vs. Display Text is also confusing.

(Are there any common circumstances where you use the Display Text for a Thing, but you're on a page for some *other* Thing? If that's not usual, I'd suggest switching Display Text to "Page Text" or "Viewed As Page" or "Page View" or something.)

[umbran.livejournal.com]

There's one thing that usually shows it better - usability testing.