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

Great work! I'm sure you're already aware of http://sphinx.pocoo.org/ which is used to generate the Python docs. A lot of good ideas there. One thing which would be great would be to integrate their javascript in-browser text search engine. Obviously not a priority but it might be nice. Best, B

Message: 14 Date: Wed, 4 Aug 2010 15:56:58 +0100 From: Thomas Schilling Subject: Re: [Haskell-cafe] Preview the new haddock look and take a        short   survey To: aditya siram Cc: haddock , haskell-cafe@haskell.org Message-ID:         Content-Type: text/plain; charset=ISO-8859-1

On 4 August 2010 15:44, aditya siram wrote:

...

I really like the color scheme and the Javadoc looking frames.

One suggestion I can make is to have the index show all the functions with type signatures without having to pick a letter. A lot of times I'll be looking for a function of a certain signature as opposed to a name. Indeed an index of type signatures would great! I remember wishing I had this when trying the understand the Parsec package.

-deech

Wouldn't hoogle be better for this kind of use case?  The index can become very large already.

More direct hoogle/hayoo integration (at least on Hackage) sounds like a worthwhile goal, though.  Noted.

...

On Wed, Aug 4, 2010 at 8:55 AM, Yitzchak Gale wrote:

...

Mark Lentczner wrote:

...

The Haddock team... Please take a look, and then give us your feedback

Very very nice. I took the survey, but here are some comments I left out.

I like the idea of the Snappy style the best, but there are two serious problems with it, at least in my browser (Safari):

1. The black on dark blue of the "Snap Packages" title makes it nearly unreadable for me. 2. The wide fonts stretch things out so far on my screen that the page becomes almost unusable.

The other styles are fine, I would use them instead.

Here is a comment I'll repeat from the survey because of its importance: Please add a "collapse all" button for the tree on the contents page. For me, that is perhaps the most urgent thing missing in all of Haddock. It would make that tree so much more usable.

Thanks for the great work, Yitz _______________________________________________ Haskell-Cafe mailing list Haskell-Cafe@haskell.org http://www.haskell.org/mailman/listinfo/haskell-cafe

_______________________________________________ Haskell-Cafe mailing list Haskell-Cafe@haskell.org http://www.haskell.org/mailman/listinfo/haskell-cafe

-- If it looks like a duck, and quacks like a duck, we have at least to consider the possibility that we have a small aquatic bird of the family Anatidae on our hands.