[GHC] #11021: Document best practices for bringing up Sphinx on Windows

[GHC]

#11021: Document best practices for bringing up Sphinx on Windows
-------------------------------------+-------------------------------------
           Reporter:  bgamari        |             Owner:
               Type:  task           |            Status:  new
           Priority:  normal         |         Milestone:  8.0.1
          Component:  Documentation  |           Version:  7.11
           Keywords:                 |  Operating System:  Unknown/Multiple
       Architecture:                 |   Type of failure:  None/Unknown
  Unknown/Multiple                   |
          Test Case:                 |        Blocked By:
           Blocking:                 |   Related Tickets:
Differential Rev(s):                 |         Wiki Page:
-------------------------------------+-------------------------------------
 The Sphinx documentation tool that we now use to generate the users guide
 is unfortunately a bit tricky to get working on Windows. See, for
 instance, https://mail.haskell.org/pipermail/ghc-
 devs/2015-October/010199.html

 We need to improve this situation or at very least document how users can
 build documentation on Windows.

--
Ticket URL: <http://ghc.haskell.org/trac/ghc/ticket/11021>
GHC <http://www.haskell.org/ghc/>
The Glasgow Haskell Compiler