Re: Switching users guide to ReStructuredText
To be honest, I'm not sure if referring to sections by numbers is a great idea. New subsections get spliced into the users' guide quite frequently, which can cause all subsequent subsections to have their numbers incremented. As a result, section numbers could become out-of-date rather quickly. Thankfully, one thing that ReStructured Text does much better than the previous system is make the entire page hyperlinkable. It's now incredibly easy to click on the symbol to the right of any section header and get a link to that spot. Ryan S.
But at least they are stable for the life of a release.
On Fri, Oct 2, 2015 at 4:06 PM, Ryan Scott
To be honest, I'm not sure if referring to sections by numbers is a great idea. New subsections get spliced into the users' guide quite frequently, which can cause all subsequent subsections to have their numbers incremented. As a result, section numbers could become out-of-date rather quickly.
Thankfully, one thing that ReStructured Text does much better than the previous system is make the entire page hyperlinkable. It's now incredibly easy to click on the symbol to the right of any section header and get a link to that spot.
Ryan S.
_______________________________________________ ghc-devs mailing list ghc-devs@haskell.org http://mail.haskell.org/cgi-bin/mailman/listinfo/ghc-devs
participants (2)
-
Alan & Kim Zimmerman -
Ryan Scott