Fix chocolatey

[twangboy]

What does this PR do?

Updates documentation
Add's deprecation notice for Chocolatey function update, along with replacement function upgrade. Looks like they're bringing it in line with other package managers. Update will be used to update package indexes.
Fixes problem where software that installed/uninstalled correctly but required a reboot, or was already installed, etc... was being reported as failed.

What issues does this PR fix or reference?

#34099

Previous Behavior

Still using deprecated functions.
Installs requiring reboot were reporting back as failed (retcode = 3010)

New Behavior

Added upgrade function to replace deprecated update function
Returns success on the following retcodes for install/upgrade:

====  ===============================================
0     Successful
1641  The installer has initiated a restart. This message is indicative of a success.
3010  A restart is required to complete the install. This message is indicative of a success. This does not include installs where the ForceReboot action is run.
====  ===============================================

Returns success on the following retcodes for uninstall

====  ===============================================
0     Successful
1605  This action is only valid for products that are currently installed.
1614  The product is uninstalled.
1641  The installer has initiated a restart. This message is indicative of a success.
====  ===============================================

Tests written?

No

[ferventcoder]

@twangboy it still works in 2003 (for how much longer though is a good question).