[Haskell-cafe] Preview the new haddock look and take a short survey

[Johan Tibell]

On Thu, Aug 5, 2010 at 3:35 PM, Dino Morelli <dino at ui3.info> wrote:

> On Wed, 4 Aug 2010, Mark Lentczner wrote:
>
> > The Haddock team has spent the last few months revamping the look of the
> generated output. We're pretty close to done, but we'd like to get the
> community's input before we put it in the main release.
> >
> > Please take a look, and then give us your feedback through a short survey
> >
> > Sample pages:  http://www.ozonehouse.com/mark/snap-xhtml/index.html
> > Frame version: http://www.ozonehouse.com/mark/snap-xhtml/frames.html
> >
>
>
> One thing I haven't seen anyone else comment on is the width of the new
> docs. I have a large (26") monitor and use the browser full-screen (with
> xmonad, so even more screen space). When I load these pages, particularly
> the non-frame one, something like 50% of my screen real-estate is empty
> whitespace on either side of the doc content. There is also wasted space
> in the frames version, just a little less of it. I wish the docs were
> using that space like the current Haddock does. Is the plan to use a
> fixed width like this?
>

Yes. There's research suggesting that the line length should be between 65
and 75 characters per line.

http://psychology.wichita.edu/surl/usabilitynews/42/text_length.htm
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://projects.haskell.org/pipermail/haddock/attachments/20100805/72f71fe3/attachment.htm