<div dir="ltr"><div><div><div><div><div><div><br></div>I've submitted a small patch for 7.10.1 to the docs, to re-arrange the order of the "important changes", since - as a "casual" user, things like the AMP/BPP seem like they should be mentioned first, before changes labelled as experimental. The change is at<br><br><a href="https://phabricator.haskell.org/D736" target="_blank">https://phabricator.haskell.org/D736</a><br><br></div>I'm sending this email to<br><br></div>a) make sure this change gets seen <br></div><br>b) ask if I did this the right way; I'm happy to write this up as an addendum to the newcomers guide/something else on the wiki if it is a sensible path for a doc-only patch<br></div><div><br></div>I followed a combination of the phabricator intro [1] and newcomers guide [2] but<br><br></div><div>1) I did not create a ticket; should I have done so? The existing documentation assumes that you are fixing a bug. It's not clearto me  if "RFE to the docs" should be treated the same way<br><br></div><div>2) since the master branch doesn't contain the 7.10 doc file, and the newcomer guide<br>assumes you are working from the master branch, I did <br><br></div><div> # downloading the submodules seems excessive for a doc-only patch<br> % git config --global url."git://<a href="http://github.com/ghc/packages-">github.com/ghc/packages-</a>".insteadOf git://<a href="http://github.com/ghc/packages/">github.com/ghc/packages/</a> <br></div><div> % git clone --recursive git://<a href="http://github.com/ghc/ghc">github.com/ghc/ghc</a><br></div><div> % cd git<br></div><div> % arc install-certificate<br></div><div> ... enter in the token as requested<br></div><div> % git checkout ghc-7.10<br></div><div>  # as I'm on a very slow download link the repository needed to be updated, so<br></div><div> % git fetch origin<br></div><div> % git pull origin ghc-7.10<br>  # since some of these were in need of updating and 'arc diff' complained<br></div><div>  % git submodule update<br></div><div>  ... edit docs/users_guide/7.10.1-notes.xml<br><br></div><div>  # just to check I didn't make any obvious snafus<br></div><div>  % xmllint 7.10.1-notes.xml<br></div><div>  % git diff<br><br></div><div>  % git add 7.10.1-notes.xml<br></div><div>  % git commit -m '...'<br><br></div><div>  # finally get to arc; the first time I tried it complained about a missing "branch"<br></div><div>  # so I guessed it made sense to use the branch I had started with, rather than the<br></div><div>  # suggested one (which I think was master)<br></div><div>  % arc diff ghc-7.10<br></div><div>  ... edit the file and guess at what to put in for reviewers (which I just left as blank<br></div><div>  and fortunately it looks like it defaults to something sensible).<br></div><div><br></div><div>Which is a rather heavy weight process when all I wanted to do was re-organize several paragraphs of a text file!<br><br></div><div>Note that I was lazy and didn't try building ghc since it really is a simple doc change and I didn't want to go and spend even more time working out what I needed to build ghc documentation.<br><br></div><div>Doug<br><br></div><div>[1] <a href="https://ghc.haskell.org/trac/ghc/wiki/Phabricator" target="_blank">https://ghc.haskell.org/trac/ghc/wiki/Phabricator</a><br>[2] <a href="https://ghc.haskell.org/trac/ghc/wiki/Newcomers" target="_blank">https://ghc.haskell.org/trac/ghc/wiki/Newcomers</a><br></div></div>