diff --git a/docs/get_started/project_create.rst b/docs/get_started/project_create.rst
index 8afd0aa..ae7aa4e 100644
--- a/docs/get_started/project_create.rst
+++ b/docs/get_started/project_create.rst
@@ -145,7 +145,7 @@
 and use the latest master branch. Release 1.0.0 is not supported on
 Windows.
 
-Run the ``newt install`` command, from your project base directory
+Run the ``newt upgrade`` command, from your project base directory
 (myproj), to fetch the source repository and dependencies.
 
 **Note:** It may take a while to download the apache-mynewt-core
@@ -154,8 +154,9 @@
 
 .. code-block:: console
 
-    $ newt install
-    apache-mynewt-core successfully installed version 1.3.0-none
+    $ newt upgrade
+    Downloading repository mynewt-core (commit: [...])
+    apache-mynewt-core successfully upgraded to version 1.7.0
 
 **Note:** If you get the following error:
 
diff --git a/docs/mynewt_faq/index.rst b/docs/mynewt_faq/index.rst
index bd3fcca..fe36e87 100644
--- a/docs/mynewt_faq/index.rst
+++ b/docs/mynewt_faq/index.rst
@@ -47,5 +47,5 @@
 
 **A**: You can simply have a separate git for your app. For example, if you followed the Blinky tutorial, your git would be in ``apps/foo``, while repos gits are in repos. You may also keep your app in the core repo, just have your own working branch for it. 
 
-Another option is to have your git repository with local packages (including apps) and have ``repository.yml`` there so ``newt install`` can download all dependencies. Just make sure to put e.g. ``bin``, ``repos``, and ``project.state``, and others in ``.gitignore`` so they are not in version control. 
+Another option is to have your git repository with local packages (including apps) and have ``repository.yml`` there so ``newt upgrade`` can download all dependencies. Just make sure to put e.g. ``bin``, ``repos``, and ``project.state``, and others in ``.gitignore`` so they are not in version control. 
 
diff --git a/docs/mynewt_faq/newt_faq.rst b/docs/mynewt_faq/newt_faq.rst
index bb75fed..464244c 100644
--- a/docs/mynewt_faq/newt_faq.rst
+++ b/docs/mynewt_faq/newt_faq.rst
@@ -5,16 +5,12 @@
   :local:
   :depth: 1
 
-Newt Commands: ``install``, ``upgrade``, ``sync``
+Newt Commands: ``upgrade``, ``install``, ``sync``
 -------------------------------------------------
 
-**Q**: What’s the difference between ``newt install``, ``newt upgrade``, and ``newt sync``?
+**Q**: What’s the difference between ``newt upgrade``, ``newt install``, and ``newt sync``?
 
-**A**: 
-
-- ``newt install``: downloads repos that aren't installed yet.  The downloaded version matches what ``project.yml`` specifies.
-- ``newt upgrade``: performs an install, but also applies to repos that are already installed.
-- ``newt sync``: fetches and pulls the latest for each repo, but does not change the branch (version).
+**A**: Only use ``newt upgrade``.  The other two commands (``install`` and ``sync``) are deprecated and will be removed soon.
 
 ``newt size`` Command vs. Elf File Size
 ---------------------------------------
@@ -27,4 +23,4 @@
 
 .. code-block:: console 
 
-  arm-none-eabi-objcopy -R .bss -R .bss.core -R .bss.core.nz -O binary ...
\ No newline at end of file
+  arm-none-eabi-objcopy -R .bss -R .bss.core -R .bss.core.nz -O binary ...
diff --git a/docs/tutorials/ble/ble_bare_bones.rst b/docs/tutorials/ble/ble_bare_bones.rst
index b63c0a9..5e4688e 100644
--- a/docs/tutorials/ble/ble_bare_bones.rst
+++ b/docs/tutorials/ble/ble_bare_bones.rst
@@ -58,13 +58,14 @@
 app may need packages from additional repos, but for now the core repo
 suits our needs.
 
-We download the dependent repos using the ``newt install`` command:
+We download the dependent repos using the ``newt upgrade`` command:
 
 ::
 
     ~/dev$ cd my_proj1
-    ~/dev/my_proj1$ newt install
-    apache-mynewt-core
+    ~/dev/my_proj1$ newt upgrade
+    Downloading repository mynewt-core (commit: [...])
+    apache-mynewt-core successfully upgraded to version 1.7.0
 
 Now it's time to create your own app.
 
diff --git a/docs/tutorials/ble/blehci_project.rst b/docs/tutorials/ble/blehci_project.rst
index 0dbce65..2eb02eb 100644
--- a/docs/tutorials/ble/blehci_project.rst
+++ b/docs/tutorials/ble/blehci_project.rst
@@ -48,8 +48,9 @@
     Project blehciproj  successfully created.
     $ cd mblehciproj 
 
-    $ newt install
-    apache-mynewt-core
+    $ newt upgrade
+    Downloading repository mynewt-core (commit: [...])
+    apache-mynewt-core successfully upgraded to version 1.7.0
 
 Create targets
 ~~~~~~~~~~~~~~
diff --git a/docs/tutorials/blinky/arduino_zero.rst b/docs/tutorials/blinky/arduino_zero.rst
index 26b153f..2f852c9 100644
--- a/docs/tutorials/blinky/arduino_zero.rst
+++ b/docs/tutorials/blinky/arduino_zero.rst
@@ -59,8 +59,9 @@
         Installing skeleton in myproj...
         Project myproj successfully created.
         $ cd myproj
-        $ newt install
-        apache-mynewt-core
+        $ newt upgrade
+        Downloading repository mynewt-core (commit: [...])
+        apache-mynewt-core successfully upgraded to version 1.7.0
         $
 
 Fetch External Packages
@@ -106,23 +107,18 @@
         user: runtimeco
         repo: mynewt_arduino_zero
 
-Install the project dependencies using the ``newt install`` command
+Install the project dependencies using the ``newt upgrade`` command
 (you can specify ``-v`` for verbose output):
 
 .. code-block:: console
 
-    $ newt install
-    apache-mynewt-core
-    mynewt_arduino_zero
+    $ newt upgrade
+    Downloading repository mynewt-core (commit: [...])
+    Downloading repository mynewt_arduino_zero (commit: [...])
+    apache-mynewt-core successfully upgraded to version 1.7.0
+    mynewt_arduino_zero successfully upgraded to version 1.7.0
     $
 
-**NOTE:** If there has been a new release of a repo used in your project
-since you last installed it, the ``1-latest`` version for the repo in
-the ``project.yml`` file will refer to the new release and will not
-match the installed files. In that case you will get an error message
-saying so and you will need to run ``newt upgrade`` to overwrite the
-existing files with the latest codebase.
-
 You need to create two targets for the Arduino Zero Pro board, one
 for the bootloader and one for the Blinky application.
 
diff --git a/docs/tutorials/blinky/blinky_primo.rst b/docs/tutorials/blinky/blinky_primo.rst
index c451371..1bab609 100644
--- a/docs/tutorials/blinky/blinky_primo.rst
+++ b/docs/tutorials/blinky/blinky_primo.rst
@@ -60,8 +60,9 @@
         Installing skeleton in myproj...
         Project myproj successfully created.
         $ cd myproj
-        $ newt install
-        apache-mynewt-core
+        $ newt upgrade
+        Downloading repository mynewt-core (commit: [...])
+        apache-mynewt-core successfully upgraded to version 1.7.0
         $
 
 Create the Targets
diff --git a/docs/tutorials/blinky/blinky_stm32f4disc.rst b/docs/tutorials/blinky/blinky_stm32f4disc.rst
index d5e45b6..7fed5d2 100644
--- a/docs/tutorials/blinky/blinky_stm32f4disc.rst
+++ b/docs/tutorials/blinky/blinky_stm32f4disc.rst
@@ -30,8 +30,9 @@
         Installing skeleton in myproj...
         Project myproj successfully created.
         $ cd myproj
-        $ newt install
-        apache-mynewt-core
+        $ newt upgrade
+        Downloading repository mynewt-core (commit: [...])
+        apache-mynewt-core successfully upgraded to version 1.7.0
         $
 
 Create the Targets
diff --git a/docs/tutorials/blinky/nRF52.rst b/docs/tutorials/blinky/nRF52.rst
index cb8f742..877a480 100644
--- a/docs/tutorials/blinky/nRF52.rst
+++ b/docs/tutorials/blinky/nRF52.rst
@@ -44,8 +44,9 @@
         Installing skeleton in myproj...
         Project myproj successfully created.
         $ cd myproj
-        $ newt install
-        apache-mynewt-core
+        $ newt upgrade
+        Downloading repository mynewt-core (commit: [...])
+        apache-mynewt-core successfully upgraded to version 1.7.0
         $
 
 Create the Targets
diff --git a/docs/tutorials/blinky/olimex.rst b/docs/tutorials/blinky/olimex.rst
index a213d7a..147f78e 100644
--- a/docs/tutorials/blinky/olimex.rst
+++ b/docs/tutorials/blinky/olimex.rst
@@ -38,8 +38,9 @@
 
         $ cd myproj
 
-        $ newt install
-        apache-mynewt-core
+        $ newt upgrade
+        Downloading repository mynewt-core (commit: [...])
+        apache-mynewt-core successfully upgraded to version 1.7.0
         $
 
 Create the Targets
diff --git a/docs/tutorials/blinky/rbnano2.rst b/docs/tutorials/blinky/rbnano2.rst
index d7dd642..69a5b4c 100644
--- a/docs/tutorials/blinky/rbnano2.rst
+++ b/docs/tutorials/blinky/rbnano2.rst
@@ -33,8 +33,9 @@
         Installing skeleton in myproj...
         Project myproj successfully created.
         $ cd myproj
-        $ newt install
-        apache-mynewt-core
+        $ newt upgrade
+        Downloading repository mynewt-core (commit: [...])
+        apache-mynewt-core successfully upgraded to version 1.7.0
         $
 
 Create the Targets
diff --git a/docs/tutorials/lora/lorawanapp.rst b/docs/tutorials/lora/lorawanapp.rst
index b17ad97..faca263 100644
--- a/docs/tutorials/lora/lorawanapp.rst
+++ b/docs/tutorials/lora/lorawanapp.rst
@@ -47,11 +47,9 @@
 
 ::
 
-        $ newt install -v 
-        apache-mynewt-core
-        Downloading repository description for apache-mynewt-core... success!
-        ...
-        apache-mynewt-core successfully installed version 1.2.0-none
+        $ newt upgrade -v 
+        Downloading repository mynewt-core (commit: [...])
+        apache-mynewt-core successfully upgraded to version 1.7.0
         ...
 
 Create the targets
diff --git a/docs/tutorials/other/wi-fi_on_arduino.rst b/docs/tutorials/other/wi-fi_on_arduino.rst
index 22f4c6f..5cb9644 100644
--- a/docs/tutorials/other/wi-fi_on_arduino.rst
+++ b/docs/tutorials/other/wi-fi_on_arduino.rst
@@ -57,8 +57,9 @@
         Installing skeleton in arduinowifi...
         Project arduinowifi successfully created.
         $ cd arduinowifi
-        $ newt install
-        apache-mynewt-core
+        $ newt upgrade
+        Downloading repository mynewt-core (commit: [...])
+        apache-mynewt-core successfully upgraded to version 1.7.0
         $
 
 Fetch External Packages
@@ -117,14 +118,16 @@
         repo: mynewt_arduino_zero 
     $
 
-Install the project dependencies using the ``newt install`` command
+Install the project dependencies using the ``newt upgrade`` command
 (you can specify ``-v`` for verbose output):
 
 .. code-block:: console
 
-    $ newt install
-    apache-mynewt-core
-    mynewt_arduino_zero
+    $ newt upgrade
+    Downloading repository mynewt-core (commit: [...])
+    Downloading repository mynewt_arduino_zero (commit: [...])
+    apache-mynewt-core successfully upgraded to version 1.7.0
+    mynewt_arduino_zero successfully upgraded to version 1.7.0
     $
 
 **NOTE:** If there has been a new release of a repo used in your project
diff --git a/docs/tutorials/sensors/air_quality_sensor.rst b/docs/tutorials/sensors/air_quality_sensor.rst
index ff69a08..a401ef8 100644
--- a/docs/tutorials/sensors/air_quality_sensor.rst
+++ b/docs/tutorials/sensors/air_quality_sensor.rst
@@ -45,8 +45,11 @@
             user: apache
             repo: mynewt-core
 
-        [user@IsMyLaptop:~/src/air_quality]$ newt install
-        apache-mynewt-core
+        [user@IsMyLaptop:~/src/air_quality]$ newt upgrade
+        Downloading repository mynewt-core (commit: [...])
+        Downloading repository mynewt-nimble (commit: [...])
+        apache-mynewt-core successfully upgraded to version 0.0.0
+        apache-mynewt-nimble successfully upgraded to version 0.0.0
         [user@IsMyLaptop:~/src/air_quality]$ ls repos/
         apache-mynewt-core
 
diff --git a/docs/tutorials/sensors/nrf52_adc.rst b/docs/tutorials/sensors/nrf52_adc.rst
index 920e63d..aa7202d 100644
--- a/docs/tutorials/sensors/nrf52_adc.rst
+++ b/docs/tutorials/sensors/nrf52_adc.rst
@@ -77,17 +77,13 @@
 
 .. code-block:: console
 
-    $ newt install -v 
-    apache-mynewt-core
-    Downloading repository mynewt-core (commit: master) ...
-    ....
-    Downloading repository mynewt-nimble (commit: master) ...
-    ....
-    Downloading repository mcuboot (commit: master) ...
-    ....
-    apache-mynewt-core successfully installed version 0.0.0
-    apache-mynewt-nimble successfully installed version 0.0.0
-    mcuboot successfully installed version 0.0.0
+    $ newt upgrade -v 
+    Downloading repository mynewt-core (commit: [...])
+    Downloading repository mynewt-nimble (commit: [...])
+    Downloading repository mcuboot (commit: [...])
+    apache-mynewt-core successfully upgraded to version 1.7.0
+    apache-mynewt-nimble successfully upgraded to version 1.2.0
+    mcuboot successfully upgraded to version 1.3.1
 
 Create the App and Targets
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
diff --git a/docs/tutorials/slinky/project-nrf52-slinky.rst b/docs/tutorials/slinky/project-nrf52-slinky.rst
index 74f5508..ada818b 100644
--- a/docs/tutorials/slinky/project-nrf52-slinky.rst
+++ b/docs/tutorials/slinky/project-nrf52-slinky.rst
@@ -36,8 +36,9 @@
     Installing skeleton in slink...
     Project slinky successfully created
     $ cd slinky
-    $newt install
-    apache-mynewt-core
+    $ newt upgrade
+    Downloading repository mynewt-core (commit: [...])
+    apache-mynewt-core successfully upgraded to version 1.7.0
 
 Create the Targets
 ~~~~~~~~~~~~~~~~~~~
diff --git a/docs/tutorials/slinky/project-sim-slinky.rst b/docs/tutorials/slinky/project-sim-slinky.rst
index 07dc8e5..2031893 100644
--- a/docs/tutorials/slinky/project-sim-slinky.rst
+++ b/docs/tutorials/slinky/project-sim-slinky.rst
@@ -32,8 +32,9 @@
     Installing skeleton in slink...
     Project slinky successfully created
     $ cd slinky
-    $newt install
-    apache-mynewt-core
+    $newt upgrade
+    Downloading repository mynewt-core (commit: [...])
+    apache-mynewt-core successfully upgraded to version 1.7.0
 
 Setting up your target build
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
diff --git a/docs/tutorials/slinky/project-stm32-slinky.rst b/docs/tutorials/slinky/project-stm32-slinky.rst
index 8a2965a..9a7b837 100644
--- a/docs/tutorials/slinky/project-stm32-slinky.rst
+++ b/docs/tutorials/slinky/project-stm32-slinky.rst
@@ -35,8 +35,9 @@
     Installing skeleton in slink...
     Project slink successfully created
     $ cd slinky
-    $newt install
-    apache-mynewt-core
+    $ newt upgrade
+    Downloading repository mynewt-core (commit: [...])
+    apache-mynewt-core successfully upgraded to version 1.7.0
 
 Create the Targets
 ~~~~~~~~~~~~~~~~~~~