* Johan Tibell <johan.tib...@gmail.com> [2011-11-17 21:09:15-0800] > Hi all, > > I spent some time today documenting a library and the experience left me > wanting a better markup language. In particular, Haddock lacks: > > * markup for bold text: bold text works better than italics for emphasis > on computer monitors. > * hyperlinks with anchor texts: having the actual URL rendered inline with > text hurts readability. > > Could Haddock markup be extended to also include some Markdown features? > The new features could be hidden behind a flag so old documentation doesn't > get unwanted markup (e.g. if it uses *...* to not mean bold). > > P.S. This good make a good weekend hack that shouldn't be too difficult.
Sounds awesome! Maybe have a switch that enables markdown and disables markup-related features of haddock (everything except linking to identifiers/modules, I believe), so that we don't affect existing docs. Then make it possible to pass this flag through cabal. -- Roman I. Cheplyaka :: http://ro-che.info/ _______________________________________________ Haskell-Cafe mailing list Haskell-Cafe@haskell.org http://www.haskell.org/mailman/listinfo/haskell-cafe
