David Abrahams wrote:
Rene Rivera <[EMAIL PROTECTED]> writes:
Very unhappy. I won't bother with a patch now. Instead here's what I
have in mind:
<http://boost.redshift-software.com/development/exemplar.html>
Great page! However, DFN should format as **bold**, not /italic/.
This convention is used by Addison-Wesley (see C++TMP) and the
rationale is unassailable, IMO. Italics tend to be skinny and
actually disappear into the page, whereas bold stands out. When
you're scanning text, it's important to be able to quickly pick out
the definition and distinguish it from the other uses.
OK I'll change that... Italics is the browser default. But I should know
by now that browser defaults are often unconventional.
The list of markup styles (Heading 4) is a classic definition
list. And for comparison... Current:
<http://www.boost.org/doc/html/InputIterator.html>
Classic:
<http://boost.redshift-software.com/doc/release/doc/html/InputIterator.html>
You mean in the "Notation" section, yes?
Yes, and the "Type expressions" section.
Without the forced italic style, and column like spacing, one can see
the style for of the "term" itself
I agree; it works better and it's an accepted formatting convention.
:-)
(bold in the later, but I just noticed that and I might remove the
bold). If that is more to peoples liking I can go change the CSS
directly.
The bold is good.
OK, bold stays :-)
Question: why the plus signs in the bullet lists? Bullets mean
bullets; plus signs mean addition (or "collapsible list item"), no?
It seems needlessly unconventional to me.
That's the current, as in the now 1 year old Boost style. It's meant to
refer to C++. But like you say it's not a common bullet style. Bullet
styles are far ranging, I've seen hundreds. Perhaps one of the square
bullet styles would work better :-)
--grafik
-------------------------------------------------------
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
