[haddock] #108: Output semantically correct HTML
haddock
haddock at projects.haskell.org
Fri May 22 08:54:11 EDT 2009
#108: Output semantically correct HTML
-------------------+--------------------------------------------------------
Reporter: tibbe | Owner: tibbe
Type: defect | Status: new
Priority: major | Milestone: _|_
Version: 2.4.2 | Resolution:
Keywords: |
-------------------+--------------------------------------------------------
Comment (by simonmar):
tibbe - I've been waiting for someone to overhaul Haddock's layout for a
long time, you have my full endorsement.
Some specific comments:
* I like to see code in a monospaced font
* I think the layout is a little less compact than the current layout.
Can't we put argument types and descriptions on the same line, as in the
current layout?
* I'd like the synopsis to be hide-able with a +/- button. Sometimes it
is huge and just gets in the way.
* don't forget the header stuff (package name, link to contents and
source code etc.)
* it's probably a good idea to do an example with all the various kinds
of Haskell declaration and markup, so we can see how they all look.
Tables aren't that bad, given that there isn't a good equivalent in CSS.
However, the horrible fixed-size cell stuff in the current Haddock layout
is very ugly, I grant you.
BTW, isn't there a copyright on that particular style? :)
--
Ticket URL: <http://trac.haskell.org/haddock/ticket/108#comment:1>
haddock <http://www.haskell.org/haddock>
Haddock, The Haskell Documentation Tool
More information about the Haddock
mailing list