[I've added the main Boost list to this response so the MPL guys can see it.]
On 3/16/06 5:46 AM, "Joel de Guzman" <[EMAIL PROTECTED]> wrote: > In the link I presented a while ago (http://snipurl.com/no8s), > you might have noticed that the headings are clickable. > Headings now link to itself. Again, this is borrowed from > the MPL docs. This allows you to right click and copy > the URL, for example (especially useful in deeply nested > sections). You know where you are, anywhere. [That URL is <http://spirit.sourceforge.net/dl_docs/quickbook_doc/quickbook/doc/html/quic kbook/intro.html>, BTW. Check out the first word "Introduction" right before the quote for the link Joel is talking about.] I've read on some web design website that this is horrible UI. This is a feature that may be "kewl" for very advanced users, but it's obscure for above-average users, and detrimental to anyone else. 1. This word is an out-link without looking like an out-link. We shouldn't be presenting data like Easter egg hunts. You could counter by saying that the disguise is a good thing to dissuade newbies, but then how could oldbies discover it without looking at the source, scrubbing the page, or reading this e-mail? (It's a variant of guideline #3 at <http://www.useit.com/alertbox/20031110.html>.) 2. Out-links to the same page is confusing to newbies. They'll think "my link click failed," not "it's a mnemonic for my browser's 'copy URL link' contextual-menu function." (It's based on guideline #10 from the web page I mentioned in [1].) 3. You implemented it as: <a name="quickbook.intro"></a><a href="intro.html" title="Introduction">Introduction</a> As I said before, using an empty "<a name>" as an in-link is a bad idea. You need to associate the link with something. AFAIK, nothing prevents an anchor from being an in- and out-link simultaneously: <a href="intro.html" name="quickbook.intro" title="Introduction">Introduction</a> If you don't care about anything before HTML-4, you can use the "id" attribute to mark destinations. (That's why it shares the same namespace as the "name" attribute.) <h2 id="quickbook.intro">Introduction</h2> So my final advice is to remove this mis-feature, and have the MPL docs purge it too. -- Daryle Walker Mac, Internet, and Video Game Junkie darylew AT hotmail DOT com ------------------------------------------------------- This SF.Net email is sponsored by xPML, a groundbreaking scripting language that extends applications into web and mobile media. Attend the live webcast and join the prime developer group breaking into this new coding territory! http://sel.as-us.falkag.net/sel?cmd=lnk&kid=110944&bid=241720&dat=121642 _______________________________________________ Boost-docs mailing list [email protected] Unsubscribe and other administrative requests: https://lists.sourceforge.net/lists/listinfo/boost-docs
