Update Readme.md

Author: gdbarron

Readme.md

@@ -1,6 +1,6 @@
 # ServiceNow
 
-[![GitHub release](https://img.shields.io/github/release/Snow-Shell/servicenow-powershell.svg)](https://github.com/Snow-Shell/servicenow-powershell/releases/latest) [![GitHub license](https://img.shields.io/github/license/Snow-Shell/servicenow-powershell.svg)](LICENSE) ![Test Coverage](https://img.shields.io/badge/coverage-75%25-yellow.svg)
+[![GitHub release](https://img.shields.io/github/release/Snow-Shell/servicenow-powershell.svg)](https://github.com/Snow-Shell/servicenow-powershell/releases/latest) [![GitHub license](https://img.shields.io/github/license/Snow-Shell/servicenow-powershell.svg)](LICENSE)
 
 This PowerShell module provides a series of cmdlets for interacting with the [ServiceNow REST API](http://wiki.servicenow.com/index.php?title=REST_API), performed by wrapping `Invoke-RestMethod` for the API calls.
 
@@ -16,28 +16,6 @@ Building on the great work the community has done thus far, a lot of new updates
 - Pipeline support added to many functions
 - Standardizing on coding between all functions
 
-## Version 1
-
-The module has been renamed from PSServiceNow to ServiceNow for version 1.  This change moves us away from the reserved "PS" prefix.  Since the name change is a major change for the user base and the project was never incremented to v1 we've taken the opportunity to label it such.
-
-In addition to the name change the following high level changes have been made:
-
-Back End:
-
-* The module structure has been updated to individual files for each function.
-* The build process has been migrated from MAKE to psake with support of the BuildHelpers module.
-* Pester testing has been expanded to cover more scenarios.
-* Improved code formatting, removed aliases, fixed file encoding.
-
-The gains are marginal in some aspects, but intended to allow for better management in the future.
-
-Front End:
-
-* The following fields are now returned in the DateTime format instead of string:  'closed_at','expected_start','follow_up','opened_at','sys_created_on','sys_updated_on','work_end','work_start'  [v1.0.1 Update: This process now attempts to format the property as DateTime based off your local culture settings, a universal `yyyy-MM-dd HH:mm:ss` format, and finally leaves the property as a string if those two convert attempts fail].
-* The formatting of returned data has been updated across all the `Get` functions except `Get-ServiceNowTable`.  This means you'll see a handful of default properties returned and can use `Format-List` or `Select-Object` to view all other properties associated with the object.
-
-These changes should improve your ability to filter on the right, especially by DateTime, as well as return more information in general.
-
 ## Requirements
 
 Requires PowerShell 3.0 or above as this is when `Invoke-RestMethod` was introduced.
@@ -50,38 +28,26 @@ Requires authorization in your ServiceNow tenant.  Due to the custom nature of S
 
 ## Usage
 
-Download the [latest release](https://github.com/Snow-Shell/servicenow-powershell/releases/latest) and  extract the .psm1 and .psd1 files to your PowerShell profile directory (i.e. the `Modules` directory under wherever `$profile` points to in your PS console) and run:
-`Import-Module ServiceNow`
-Once you've done this, all the cmdlets will be at your disposal, you can see a full list using `Get-Command -Module ServiceNow`.
+The ServiceNow module should be installed from the PowerShell Gallery with `install-module ServiceNow`.
 
-### Example - Using Set-ServiceNowAuth
+### Creating a new session
 
 ```PowerShell
-Set-ServiceNowAuth -url InstanceName.service-now.com -Credentials (Get-Credential)
+New-ServiceNowSession -url InstanceName.service-now.com -Credentials (Get-Credential)
 ```
 
-The URL should be the instance name portion of the FQDN for your instance.  If you browse to `https://yourinstance.service-now.com` the URL required for the module is `yourinstance.service-now.com`.
+This example is using basic authentication, but OAuth is available as well; see the built-in help for `New-ServiceNowSession`.  All examples below assume a new session has already been created.
 
 ### Example - Retrieving an Incident Containing the Word 'PowerShell'
 
 ```PowerShell
-Import-Module ServiceNow
-Set-ServiceNowAuth
 Get-ServiceNowIncident -MatchContains @{short_description='PowerShell'}
 ```
 
-### Example - Retrieving an Incident Containing the Word 'PowerShell' While Passing Authentication
-
-```PowerShell
-Import-Module ServiceNow
-Get-ServiceNowIncident -MatchContains @{short_description='PowerShell'} -ServiceNowCredential $PSCredential -ServiceNowURL $ServiceNowURL
-```
-
 ### Example - Update a Ticket
 
 ```PowerShell
-$Incident = Get-ServiceNowIncident -Limit 1 -MatchContains @{short_description='PowerShell'}
-Update-ServiceNowIncident -SysID $Incident.Sys_ID -Values @{comments='Updated via PowerShell'}
+Get-ServiceNowIncident -Limit 1 -MatchContains @{short_description='PowerShell'} | Update-ServiceNowIncident -Values @{comments='Updated via PowerShell'}
 ```
 
 ### Example - Creating a Incident with custom table entries
@@ -102,41 +68,13 @@ The module can use the `Connection` parameter in conjunction with the included `
 
 The `Connection` parameter accepts a hashtable object that requires a username, password, and ServiceNowURL.
 
-## Functions
-
-* Add-ServiceNowAttachment
-* Get-ServiceNowAttachment
-* Get-ServiceNowAttachmentDetail
-* Get-ServiceNowChangeRequest
-* Get-ServiceNowConfigurationItem
-* Get-ServiceNowIncident
-* Get-ServiceNowRequest
-* Get-ServiceNowRequestItem
-* Get-ServiceNowTable
-* Get-ServiceNowTableEntry
-* Get-ServiceNowUser
-* Get-ServiceNowUserGroup
-* New-ServiceNowChangeRequest
-* New-ServiceNowIncident
-* New-ServiceNowSession
-* New-ServiceNowQuery
-* New-ServiceNowTableEntry
-* Remove-ServiceNowAttachment
-* Remove-ServiceNowTableEntry
-* Test-ServiceNowAuthIsSet
-* Update-ServiceNowChangeRequest
-* Update-ServiceNowIncident
-* Update-ServiceNowNumber
-* Update-ServiceNowRequestItem
-* Update-ServiceNowTableEntry
-
 ## Tests
 
-This module comes with [Pester](https://github.com/pester/Pester/) tests for unit testing.
+This module comes with limited [Pester](https://github.com/pester/Pester/) tests for unit testing.
 
 ## Scope & Contributing
 
-This module has been created as an abstraction layer to suit my immediate requirements. Contributions are gratefully received however, so please feel free to submit a pull request with additional features or amendments.
+Contributions are gratefully received, so please feel free to submit a pull request with additional features or amendments.
 
 ## Authors