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.
-------------- next part --------------
An HTML attachment was scrubbed...
More information about the Haddock