[Haddock] first post-survey version
marlowsd at gmail.com
Mon Aug 16 06:58:11 EDT 2010
On 15/08/2010 17:19, Mark Lentczner wrote:
> Here is my latest version for viewing:
> You'll notice that I've started including the containers package in
> there for comparison.
> Things changed in this version:
> • Completely redone font sizing, following the sage advice of A List
> Apart and the browser workarounds from the YUI 3. This should be
> "industry best practices" and matches what the "big boys" do. I
> admit, the main font size got a touch smaller. Every thing has been
> tweaked to be much more consistent, and is sized to match what
> "heavy hitters" in on-line documentation do.
The body text looks fine, but the font size in type signatures and
declarations looks a bit big to me.
> • Synopsis drawer layout issues seem fixed. It works on both FireFox
> and Chrome on my Mac, and in every browser I tested via BrowserShots(*).
Looks ok here. Though I agree with the people who are saying that a
pane on the left would be better than the slide-out synopsis.
> • Some more white space between declarations (it had somehow gotten
> to only 0.5em!)
This is an improvement, declarations look separate from each other now,
rather than like an interleaved sequence of headings and documentation.
However I think we should have a bit more vertical space between a
plain paragraph and a declaration (see e.g. the beginning of the "Hook
functions" section in Text.Templating.Heist).
In the contents page, clicking on a module still performs two actions
simultaneously: expand/collapse and open.
More information about the Haddock