Re: [RFC] Moving user's guide to ReStructuredText

2015-09-23 Thread Iavor Diatchki
Hello, thanks for doing this Ben! +1 for me too. Like others, I don't like editing XML by hand. As to which other format to use, I trust your judgement---I've used a bunch of them, and in my mind they are all fairly similar, and I always have to look up how exactly things work anyway, so whate

Re: [RFC] Moving user's guide to ReStructuredText

2015-09-23 Thread David Luposchainsky
I really like the idea of having a readable raw format that renders nice. Editing is awful, yes, but we don't have to do it that often. But what matters much more to me, and in fact most GHC users, is searchability. I don't want to enter the user's guide via Google, and grepping through HTML is no

Re: [RFC] Moving user's guide to ReStructuredText

2015-09-23 Thread Christopher Allen
The GHC docs in general could use some love. The navigation isn't that nice. On Wed, Sep 23, 2015 at 9:32 AM, wrote: > You might consider the Racket documentation ecosystem: > > http://pkg-build.racket-lang.org/doc/scribble/index.html > > or > > http://pkg-build.racket-lang.org/doc/polle

[RFC] Moving user's guide to ReStructuredText

2015-09-23 Thread harold_carr
You might consider the Racket documentation ecosystem: http://pkg-build.racket-lang.org/doc/scribble/index.html or http://pkg-build.racket-lang.org/doc/pollen/ ___ ghc-devs mailing list ghc-devs@haskell.org http://mail.haskell.org/cgi-bin/mailm

Re: [RFC] Moving user's guide to ReStructuredText

2015-09-23 Thread Ben Gamari
Ben Gamari writes: > Hello all! > I have collected the details of this proposal into a Wiki page[1]. Feel free to leave thoughts there as well as this thread. Cheers, - Ben [1] https://ghc.haskell.org/trac/ghc/wiki/UsersGuide/MoveFromDocBook signature.asc Description: PGP signature

Re: [RFC] Moving user's guide to ReStructuredText

2015-09-23 Thread Richard Eisenberg
I know nothing about these different formats. But I dislike what we have now, and I have confidence that you *do* know something about these formats. So I'm very happy to take your recommendation on this. +1 Thanks! Richard On Sep 23, 2015, at 4:02 AM, Ben Gamari wrote: > Hello all! > > Las

ANN: CfN for new Haskell Prime language committee

2015-09-23 Thread Herbert Valerio Riedel
Dear Haskell Community, In short, it's time to assemble a new Haskell Prime language committee. Please refer to the CfN at https://mail.haskell.org/pipermail/haskell-prime/2015-September/003936.html for more details. Cheers, hvr -- PGP fingerprint: 427C B69A AC9D 00F2 A43C AF1C BA3C BA3F

[RFC] Moving user's guide to ReStructuredText

2015-09-23 Thread Ben Gamari
Hello all! Last year there was a brief thread [1] on this list discussing the choice of markup language used for GHC's users guide. At this point DocBook is showing signs of age, * The format's documentation is ancient and isn't terribly approachable. * Writing XML by hand is a terrible, ter