[RFC] Moving user's guide to ReStructuredText
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/
The GHC docs in general could use some love. The navigation isn't that nice.
On Wed, Sep 23, 2015 at 9:32 AM,
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/mailman/listinfo/ghc-devs
-- Chris Allen Currently working on http://haskellbook.com
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 not very fruitful. A markdown-ish format gives us a lot of our usual tools to work with the manual. Huge +1 from me. David
participants (3)
-
Christopher Allen -
David Luposchainsky -
harold_carr＠hotmail.com