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

Ben midfield at gmail.com
Wed Aug 4 13:16:24 EDT 2010


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 <nominolo at googlemail.com>
> Subject: Re: [Haskell-cafe] Preview the new haddock look and take a
>        short   survey
> To: aditya siram <aditya.siram at gmail.com>
> Cc: haddock <haddock at projects.haskell.org>, haskell-cafe at haskell.org
> Message-ID:
>        <AANLkTincL6oUsUJ6hFdi+3-UaO2bqmrX-p8dvRzYME2- at mail.gmail.com>
> Content-Type: text/plain; charset=ISO-8859-1
>
> On 4 August 2010 15:44, aditya siram <aditya.siram at gmail.com> 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 <gale at sefer.org> 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 at haskell.org
>>> http://www.haskell.org/mailman/listinfo/haskell-cafe
>>
>>
>> _______________________________________________
>> Haskell-Cafe mailing list
>> Haskell-Cafe at 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.
>


More information about the Haskell-Cafe mailing list