[Doc-SIG] [Python-Dev] [Preview] Comments and change proposals on documentation

Alexander Belopolsky alexander.belopolsky at gmail.com
Mon Nov 29 17:07:03 CET 2010

On Mon, Nov 29, 2010 at 3:52 AM, Georg Brandl <g.brandl at gmx.net> wrote:
>> Yes, I failed to fully read the instructions you sent, or understand
>> them. That's what users do -- they don't read your instructions, and
>> they misunderstand them. If your UI isn't easily discoverable, users
>> will not be able to use it, and will be frustrated and annoyed. The user
>> is always right, even when they're doing it wrong *wink*
> That's right, of course.  I really come to the conclusion that having a text
> link that "looks like" a link, i.e. is underlined, will have a better UI
> experience (since we cannot put notes "click bubble to comment" everywhere).
Please don't make comment bubbles more visible.  Doing so will only
decrease signal to noise ratio.  I think a little bit of a learning
barrier is a good thing: it will keep down the number of "Bart was
here" comments.

More information about the Doc-SIG mailing list