Repo: Add upgrade instructions to the Admin Guide (in addition to current location)

[stephenakearns]

@ijstokes commented on Wed Jun 29 2016

I've looked through docs.continuum.io and there are no clear upgrade instructions for Anaconda Repository. My original skim of the admin docs and review of the documentation side bar revealed nothing. I tried a search, same story: no useful links (aside: search needs some work to be uesful, I'd say). I went back and reviewed the admin docs in more detail and happened upon this:

https://docs.continuum.io/anaconda-repository/install#configure-anaconda-repository

Note that the docs use the term "upgrade" whereas the Conda command is "update", which is what I was originally searching for. In any case, this is the "configuration" section, so it was only from doing an in-page full-text search for "upgrade" that I came across this hint about a step required when doing a "conda-update". But for sure I have no idea if I've done the right things. Surely this is documented somewhere but I had no ability to identify it.

I would suggest:

• Make "update" (or "upgrade" if you insist) a clear section in the Admin docs side menu.
• Provide the documentation (if they don't already exist somewhere)
• Figure out how to get better search results

Ah ha! I added more terms to my search and I discovered that the upgrade instructions do exist, apparently in the Change Log! I found them here:

https://docs.continuum.io/anaconda-repository/index

Note that this is:

• Not in the Administrator Guide
• After the User Guide (so I stopped looking)
• And inside a section called "What's new in 2.18.0?" (which seemed irrelevant to me: I just wanted the latest version, not a summary of the change log)