david.waern at gmail.com
Wed Jul 21 06:38:38 EDT 2010
2010/7/21 Johan Tibell <johan.tibell at gmail.com>:
> 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.
More information about the Haddock