David Abrahams wrote:
Joel de Guzman <[EMAIL PROTECTED]> writes:
That's what you have to do, neh? You click once to get to the TOC,
then you right-click the link at the top of the page.
Tedious and possibly error prone, IMO ;)
I should add that it could only be considered tedious and error-prone
from the POV of someone who wants to provide a link to the section.
For the ordinary browsing user, who wants to see where in the overall
outline of the document he is currently, the no-op link is
*definitely* tedious: it doesn't do anything! It's also confusing, of
course.
I think serving the ordinary browsing user is much more important than
serving the guy who wants to provide a link to the section, especially
if the difference is just one click.
Not exactly true. In fact it benefits the one who will use the link
more than the one who does the link. First, let me say that indeed
the MPL docs, as far as headings are concerned, does it the same
way as QuickBook. In my other post, I posed a usage scenario. I'll
repeat parts of it here for reference.
Anyway, imagine I have a doc that links to the "Invariants" section
of the MPL doc's "ForwardSequence" concept at http://tinyurl.com/omouw.
Thanks to the self links of headings in the MPL docs, I can know
the exact location. For reference it is at:
http://www.boost.org/libs/mpl/doc/refmanual/forward-sequence.html#invariants
AFAICT, there is no way to know that if the heading itself is
not self linked.
The only way is to link to the page and say, "ok, please go to
link http://tinyurl.com/omouw and see section Invariants." How
usable is that? The user will have to search a potentially long
page for the particular /Invariants/ section. 1) Imagine if the
page is long. 2) What if there are more than one /Invariants/
in various sub-sections?
Regards,
--
Joel de Guzman
http://www.boost-consulting.com
http://spirit.sf.net
-------------------------------------------------------
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
