new documentation format for std.algorithm

[spir]

On 02/03/2011 04:11 PM, 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.

+++ (that's how I understand the issue as well, virulence apart)

A particular point is when you need a rather wide horizontal space, like in the 
initial design of the cheat sheet. This is to be avoided as much as possible 
because layout will be broken by people using narrow/low resolution devices or 
needing larger fonts than you have in mind or just test with.
In all cases, I guess the proper method is to avoid setting absolute widths (or 
implicitely requiring big ones via layout design such in the case of the cheat 
sheet) and just let content flow, according to user-side /actual/ width.

Denis
-- 
_________________
vita es estrany
spir.wikidot.com