[Haskell-cafe] Re: [Haskell] Making Haskell more open
simonmar at microsoft.com
Wed Nov 16 11:38:18 EST 2005
On 14 November 2005 08:32, Gour wrote:
> Nobody said that DocBook does not work fine. However let me quote
> SPJ's message:
> However, I still wonder if there are things we could do that would
> it easier for people to contribute. Here are two concrete
> suggestions: ^^^^^^^
> - Make it possible for people to add comments, explanations, or
> questions to
> * The GHC user manual [currently generated using DocBook]
> * The Haskell 98 Report
> The idea would be that anyone could help improve these documents,
> and that, at least in the case of the GHC user manual, we could
> use the comments to help clarify the text.
> So, the whole discussion, at least from my side, was to offer
> suggestions to make it easier for more people to contribute to the
> whole haskell community.
With regard to the GHC user manual, I don't think the implication above
was that we should change the markup technology (at least, I agree with
Sven that DocBook XML is on the whole a reasonable solution).
The idea was to make it easy for Joe Programmer to add his comments to
the manual, whether by a wiki link or some other clever user-editable
content mechanism. In a separate stage the comments could be
incorporated into the manual proper by the developers, or just left in
place for the edification of other users.
More information about the Haskell-Cafe