From 21eab5abbbe673a5ac6d7588ee174c5d490e9eb9 Mon Sep 17 00:00:00 2001
From: Kenneth Reitz <me@kennethreitz.org>
Date: Wed, 28 Feb 2018 11:33:07 -0500
Subject: [PATCH] upgrade workflow

Signed-off-by: Kenneth Reitz <me@kennethreitz.org>
---
 docs/basics.rst | 18 +++++++++++++-----
 1 file changed, 13 insertions(+), 5 deletions(-)

diff --git a/docs/basics.rst b/docs/basics.rst
index b4948172..b547ac92 100644
--- a/docs/basics.rst
+++ b/docs/basics.rst
@@ -138,18 +138,26 @@ Create a Pipfile.lock from the installed versions::
 
 Install from that Pipfile.lock::
 
-    $ pipenv install --ignore-pipfile
-    
+    $ pipenv install
+
 Activate the pipenv shell::
 
-    $ pipenv shell   
-    
+    $ pipenv shell
+
 Exit the pipenv shell::
 
-    $ exit   
+    $ exit
 
 .. _initialization:
 
+☤ Example Pipenv upgrade workflow
+---------------------------------
+
+- Find out what's changed upstream: ``$ pipenv update --outdated``.
+- Upgrade packages, two options:
+  a. Want to upgrade everything? Just do ``$ pipenv update``.
+  b. Want to upgrade packages one-at-a-time? ``$ pipenv update <pkg>`` for each outdated package.
+
 ☤ Importing from requirements.txt
 ---------------------------------