Update documentation and add logic for AzureRM.psd1 release notes

Author: cormacpayne

.github/PULL_REQUEST_TEMPLATE.md

@@ -12,6 +12,8 @@ If applicable, reference the bug/issue that this pull request fixes here.
 This checklist is used to make sure that common guidelines for a pull request are followed. You can find a more complete discussion of PowerShell cmdlet best practices [here](https://msdn.microsoft.com/en-us/library/dd878270(v=vs.85).aspx).
 
 - [ ] **I have read the [contribution guidelines](https://github.com/Azure/azure-powershell/blob/dev/CONTRIBUTING.md).**
+- [ ] **If changes were made to any cmdlet, the XML help was regenerated using the [platyPSHelp module](https://github.com/Azure/azure-powershell/blob/dev/documentation/platyps-help.md).**
+- [ ] **If any large changes are made to a service, they are reflected in the respective [change log](https://github.com/Azure/azure-powershell/blob/dev/CONTRIBUTING.md#updating-the-change-log).**
 
 ### [General Guidelines](https://github.com/Azure/azure-powershell/blob/dev/CONTRIBUTING.md#general-guidelines)
 - [ ] Title of the pull request is clear and informative.

CONTRIBUTING.md

@@ -26,6 +26,7 @@ In the Azure Developer Experience, you are at Step 5:
 - [SDK for .NET](#sdk-for-net)
 - [Pull Request Guidelines](#pull-request-guidelines)
     - [Cleaning up commits](#cleaning-up-commits)
+    - [Updating the change log](#updating-the-change-log)
     - [General guidelines](#general-guidelines)
     - [Testing guidelines](#testing-guidelines)
     - [Cmdlet signature guidelines](#cmdlet-signature-guidelines)
@@ -104,6 +105,16 @@ If splitting up the pull request is not an option, we recommend **creating indiv
 
 For more information on cleaning up the commits in a pull request, such as how to rebase, squash, and cherry-pick, click [here](./documentation/cleaning-up-commits.md).
 
+#### Updating the change log
+
+Any large changes that are made to a service must be reflected in the respecitve change log. This change log will allow customers to easily track what has been changed between releases of a service.
+
+For ResourceManager services, the change log is located at `src\ResourceManager\SERVICE\ChangeLog.md`.
+
+For ServiceManagement services, the change log is located at `src\ServiceManagement\Services\Commands.Utilities\ChangeLog.md`.
+
+For Storage, this change log is located at `src\Storage\ChangeLog.md`.
+
 #### General guidelines
 
 The following guidelines must be followed in **EVERY** pull request that is opened.

tools/UpdateChangeLog.ps1

@@ -384,9 +384,12 @@ $StorageResult = UpdateLog -PathToChangeLog $PathToChangeLog -PathToModule $Path
 $result = @()
 
 # If any changes were made to ARM services, add them to the list to be added to the master change log
+# Also, we need to update AzureRM.psd1 with all of the changes made to ARM services
 if ($ResourceManagerResult.Length -gt 0)
 {
     $result += $ResourceManagerResult
+
+    UpdateModule -PathToModule "$PathToRepo\tools\AzureRM\AzureRM.psd1" -ChangeLogContent $ResourceManagerResult
 }
 
 # If any changes were made to RDFE services, add them to the list to be added to the master change log