Add section about system upgrades in OI hipster

* add section about system upgrades in OI hipster

* added a quickstart to IPS and linked from upgrade system

---------

Co-authored-by: J Madgwick <[email protected]>

docs/handbook/getting-started.md

@@ -562,13 +562,13 @@ As it runs, you will be prompted with a few questions.
 
     Secure boot (UEFI boot path validation) must be disabled (if it is enabled by default) because UEFI secure boot is currently not yet supported.
 
-    For further information, consult the manufacturers documentation for your computer hardware.
+    For further information, consult the manufacturer's documentation for your computer hardware.
 </div>
 
 ### Booting the OpenIndiana installer on virtual hardware
 
 The most efficient way to boot a virtual machine is to boot directly from the DVD ISO file.
-Alternately, you may use host to guest DVD/USB passthrough to boot from physical media.
+Alternately, you may use host-to-guest DVD/USB passthrough to boot from physical media.
 See the notes below for optimizing OpenIndiana for several popular hypervisors.
 
 | Hypervisor | Configuration Notes
@@ -1413,11 +1413,49 @@ Use the following steps to change the root password:
 <div class="note" markdown="1">
 !!! note
     The image packaging system is delivered as part of the OpenIndiana userland.
-    As such, the pkg related man pages are not available on the illumos.org website.
+    As such, the pkg-related man pages are not available on the illumos.org website.
     These pages are only available by running the man page viewer locally on your system.
 </div>
 
-### Introduction
+### Quick Start to IPS
+
+As a desktop user, you will likely want to enable the `Software Installation` profile for
+your user; you can use `sudo` instead of `pfexec` if you are just getting started with
+OpenIndiana and are not yet familiar with RBAC (role-based authentication), being sure
+to replace `username` with your actual username:
+
+
+```
+sudo usermod -P "Software Installation" username
+```
+
+Now you can use `pfexec` to execute `pkg install`
+
+
+For instance, you may want to search for the `emacs` editor by running `pkg search -p emacs`
+
+```
+$ pkg search -p emacs
+PACKAGE                                                PUBLISHER
+pkg:/developer/[email protected]          openindiana.org
+pkg:/editor/gnu-emacs/[email protected]    openindiana.org
+pkg:/editor/gnu-emacs/[email protected]   openindiana.org
+pkg:/editor/gnu-emacs/[email protected] openindiana.org
+pkg:/editor/gnu-emacs/[email protected]    openindiana.org
+pkg:/editor/[email protected]                  openindiana.org
+
+```
+
+
+Then you can install the one that you like by copying and pasting the FMRI (see more details on that later) into a `pkg install` command:
+
+
+```
+pfexec pkg install pkg:/editor/gnu-emacs/[email protected]
+```
+
+
+### IPS Overview
 
 <!--The majority of the text below was taken from the PDL licensed document titled 'Getting Started with OpenSolaris 2008.11' -->
 

docs/handbook/systems-administration.md

@@ -751,6 +751,26 @@ onto the system before changing the run-level.
    process is not interrupted by system prompts requiring user-interactive
    intervention.
 
+
+## Updating All Packages (Upgrading Your System)
+
+OpenIndiana Hipster is a rolling release
+distribution, so to upgrade your system, you simply run `pkg update`
+all packages will be updated to the latest revision:
+
+```sh
+pfexec pkg update
+```
+
+(Note: for `pfexec` to succeed you'll need to have the `Software Installation` profile [enabled for your user account](../getting-started/#quick-start-to-ips).)
+
+
+New installation images are beneficial for those
+with newer hardware that illumos may have added
+support for, but the above command should suffice
+for existing installations.
+
+
 ## Service Management Facility
 
 Services are an extension to processes.