new documentation format for std.algorithm

["Jérôme M. Berger"]

Andrei Alexandrescu wrote:
> On 2/3/11 9:11 AM, Jeff Nowakowski wrote:
>> On 02/03/2011 01:21 AM, Andrei Alexandrescu wrote:
>>>
>>> Someone mentioned in this thread that leaving all font sizes to default
>>> causes the text to be too small.
>>>
>>> The rhetoric is convincing but I'm afraid it can't be properly
>>> translated into reality.
>>
>> It doesn't matter *what* you choose, somebody will complain it is too
>> small or too large. That doesn't mean that some choices aren't better
>> than others. Going by default size and making the fonts relative to that
>> is the way to go, assuming smaller sizes are justified to squeeze in
>> text to cramped spaces.
>>
>> Large blocks of text descriptions should be at the default size. Then if
>> somebody complains about that, tell them to fix their defaults instead
>> of imposing their monitor and browser settings on the rest of the
>> Internet.
> 
> Apparently at least for one person choosing the default makes the text
> too large. Making the default smaller in turn makes Wikipedia text too
> small.
> 
	That is because Wikipedia text *is* to small! Wikipedia has the
font size set to 80% of the default, which means that they *want*
their text to be too small. That is not a reason why we should
emulate them.

		Jerome
-- 
mailto:jeberger at free.fr
http://jeberger.free.fr
Jabber: jeberger at jabber.fr

-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 198 bytes
Desc: OpenPGP digital signature
URL: <http://lists.puremagic.com/pipermail/digitalmars-d/attachments/20110203/99d18aac/attachment-0001.pgp>