Rene Rivera wrote:
David Abrahams wrote:
I don't see a contextual difference.  It all ends up in a browser
window, doesn't it?

Yes, although the offline use is more likely to also get printed out.

You can cater for both on-screen and printed versions by putting the screen specific code into a @media screen section and the printed specific logic in @media print, e.g.:

@media screen
{
  body { font-family: sans-serif; }
  a:link { color: blue; }
}

@media print
{
  body { font-family: Times New Roman, serif; }
  a:link { text-decoration: normal; color: black; }
}

so you get a good L&F for both versions.

They are likely to get used differently. There's been mention from some that they mostly use the docs in a scanning mode, while others tend to sit and read carefully. I think that the former is more likely a use of the online docs, and the latter of the offline docs. But more explicitly the offline docs won't have all the navigation and interactive (i.e. the webnotes) hence they can be tailored without the worry that they will clash with those elements to make for the easiest to read.

@media print
{
  .webnotes { display: none; }
}

:)

While the online docs might be tailored for scanning and searching.

Sure.

I think that exactly Joel's point :-) You'll be happy, but someone else will be angry. And unlike libraries where the friction is minimized most of the time because it's something that library author will deal with individually. The design is something that affects everyone.

I personally really like what you have done with the redesing. Adding the blue on the headings makes a real difference!

As with Dave and Joel, I'm not keen on the link style (especially as there appears to be different, inconsistent styling across them). Having said that, I like the links in the table of contents.

How about following the W3C?:

@media screen
{
  a:link { text-decoration: underline; color: blue; }
  a:hover { cursor: pointer; }
}

@media print
{
  a:link { text-decoration: none; color: black; }
}

- Reece




-------------------------------------------------------
This SF.net email is sponsored by: Splunk Inc. Do you grep through log files
for problems?  Stop!  Download the new AJAX search engine that makes
searching your log files as easy as surfing the  web.  DOWNLOAD SPLUNK!
http://sel.as-us.falkag.net/sel?cmd=lnk&kid=103432&bid=230486&dat=121642
_______________________________________________
Boost-docs mailing list
[email protected]
Unsubscribe and other administrative requests: 
https://lists.sourceforge.net/lists/listinfo/boost-docs

Reply via email to