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

Ivan Lazar Miljenovic ivan.miljenovic at gmail.com
Wed Aug 4 06:34:14 EDT 2010

Magnus Therning <magnus at therning.org> writes:

> On Wed, Aug 4, 2010 at 06:00, Mark Lentczner <markl at glyphic.com> 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
> I really like it, especially the synopsis tab on the right.  Brilliant!  The
> TOC is nice too!  The over-all impression is that it doesn't look as
> auto-generated as the old style.

Agreed; I'm also glad that the usage of a middle column isn't a fixed
width but resizes as the text resizes (the lack of this is something
that annoys me to no end on some websites).

>> Frame version: http://www.ozonehouse.com/mark/snap-xhtml/frames.html
> Also very good looking.  Does the current stable version of Haddock really
> create a frame version?
> I've never seen one before...

There is, but I for one don't use it (and there was an email sent out in
May asking if anyone did:
http://www.mail-archive.com/haskell-cafe@haskell.org/msg75269.html ).

I quite like this new approach, however, but with one caveat: the empty
frame on the bottom left at default.  Especially with my weird firefox
setup (which has almost grown organically over the years and should
really be wiped), it doesn't display too well; is it possible to have
_something_ there by default just to make it look more interesting
(Haskell logo, a message saying "stuff will appear here when you click
on something above", etc.) ?

However, I would still be highly tempted to use the framed version by
default with that new layout.

Ivan Lazar Miljenovic
Ivan.Miljenovic at gmail.com

More information about the Haddock mailing list