CSS Themes

Johan Tibell johan.tibell at gmail.com
Wed Jul 21 05:37:10 EDT 2010


On Wed, Jul 21, 2010 at 11:34 AM, Simon Marlow <marlowsd at gmail.com> wrote:

> On 21/07/2010 07:13, Mark Lentczner wrote:
> > So, this leads me to ponder two questions:
> >
> > A) How important is it to develop the Style switcher? 1, 3, and 5
> > point to it being a minor feature - perhaps used primarily by theme
> > creators. 2 and 4 suggest we fully develop to enable user choice.
> >
> > B) How open will the community be to our designing the new look of
> > Haskell documentation?
> >
> > Thoughts?
>
> I vote for:
>
>  * Work on a really nice theme that we all pretty much agree on.
>    Right now, Thomas's is looking like the front runner to me.
>
>  * Make this the default Haddock style.
>
>  * Don't include a style switcher in the generated Haddock, at
>    least by default.  It's a knob that most people don't need,
>    and we should focus on doing one thing really well; delegating
>    choice to the user is a cop-out.
>
>  * Nevertheless, make it easy to switch styles for developers
>    who want to style their own API documentation.
>
> So to answer your Qs directly:
>
>  A) not terribly important, make it an optional feature
>  B) I don't think this will a problem.  If you're worried then
>     you could have a beta phase and ask for comments, but that's
>     likely to lead to a huge thread on haskell-cafe with low
>     SNR.  There are enough people involved in this effort
>     with the skills to produce a great result, so let's just
>     do it.
>

+1
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://projects.haskell.org/pipermail/haddock/attachments/20100721/506d7ee3/attachment-0001.htm 


More information about the Haddock mailing list