617 check and upgrade source install upgrade docs

I have rewritten the source install upgrade docs, checked that they worked and have filed an additional issue related to update filestore data referencing. 

Only one file was changed: install-from-source.rst
New file created: upgrade.rst (will also, eventually, contain upgrade for package version when we later restructure the docs, can be ignored for now.)