Merge remote-tracking branch 'upstream/dev' into dev-anilyela

Author: Anil Kumar Yelam

.github/ISSUE_TEMPLATE.md

@@ -0,0 +1,16 @@
+### Cmdlet(s)
+
+### PowerShell Version
+Instructions: to get PowerShell version, type `$PSVersionTable` and look for the value associated with `PSVersion`
+
+### Module Version
+
+### OS Version
+Instructions: to get OS version, type `$PSversionTable` and look for value associated with `BuildVersion`
+
+### Description
+
+### Debug Output
+Instructions: to get Debug Output, set `$DebugPreference="Continue"` and then execute the cmdlet or script causing the issue
+
+### Script/Steps for Reproduction

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,55 @@
+This checklist is used to make sure that common issues in a pull request are covered by the creator. 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).
+
+Below in **Overall Changes**, check off the boxes that apply to your PR. Within each of the categories that you select, make sure that you can check off **all** of the boxes.
+
+## Overall Changes 
+- [ ] [**MANDATORY** - General changes](#general)
+- [ ] [**MANDATORY** - Add/remove/edit test(s)](#tests)
+- [ ] [Add/remove/edit cmdlet(s)](#cmdlet-signature)
+- [ ] [Add/remove/edit parameter(s)](#parameters)
+- [ ] [Edit pipeline parameters](#parameters-and-the-pipeline)
+
+### General
+- [ ] Title of the PR is clear and informative
+- [ ] There are a small number of commits that each have an informative message
+- [ ] If it applies, references the bug/issue that the PR fixes
+- [ ] All files have the Microsoft copyright header
+- [ ] Cmdlets refer to management libraries through nuget references - no dlls are checked in
+- [ ] The PR does not introduce breaking changes (unless a major version change occurs in the assembly and module)
+
+### Tests
+- [ ] PR includes test coverage for the included changes
+- [ ] Tests must use xunit, and should either use Moq to mock management client calls, or use the scenario test framework
+- [ ] PowerShell scripts used in tests must not use hard-coded values for location
+- [ ] PowerShell scripts used in tests should do any necessary setup as part of the test or suite setup, and should not use hard-coded values for existing resources
+- [ ] Tests should not use App.config files for settings
+- [ ] Tests should use the built-in PowerShell functions for generating random names when unique names are necessary - this will store names in the test recording
+- [ ] Tests should use Start-Sleep to pause rather than Thread.Sleep
+
+### Cmdlet Signature
+- [ ] Cmdlet name uses an approved PowerShell verb - use the enums for `VerbsCommon`, `VerbsCommunication`, `VerbsLifecycle`, `VerbsOther` whenever possible
+- [ ] Cmdlet noun name uses the AzureRm prefix for management cmdlets, and the Azure prefix for data plane cmdlets
+- [ ] Cmdlet specifies the `OutputType` attribute if any output is produced; if the cmdlet produces no output, it should implement a `PassThrough` parameter
+- [ ] If the cmdlet makes changes or has side effects, it should implement `ShouldProcess` and have `SupportShouldProcess = true` specified in the cmdlet attribute. See a discussion about correct `ShouldProcess` implementation [here](https://gist.github.com/markcowl/338e16fe5c8bbf195aff9f8af0db585d#what-is-the-change)
+- [ ] Cmdlets should derive from AzureRmCmdlet for management cmdlets, and AzureDataCmdlet for data cmdlets
+- [ ] If multiple parameter sets are implemented, the cmdlet should specify a `DefaultParameterSetName` in its cmdlet attribute
+
+### Parameters
+- [ ] Cmdlets should have no more than four positional parameters
+- [ ] Cmdlet parameter sets should be mutually exclusive - each parameter set must have at least one mandatory parameter not in other parameter sets
+- [ ] Parameter types should not expose types from the management library - complex parameter types should be defined in the module
+- [ ] Complex parameter types are discouraged - a parameter type should be simple types as often as possible. If complex types are used, they should be shallow and easily creatable from a constructor or another cmdlet
+- [ ] Parameters should be explicitly marked as Mandatory or not, and should contain a HelpMessage
+- [ ] No parameter is of type `object`.
+    - Management cmdlets should have the following parameters and aliases:
+        - ResourceGroupName with (optional) alias to `ResourceGroup` type string marked as [ValueFromPipelineByPropertyName]
+        - Name with alias to `ResourceName` type string marked as [ValueFromPipelineByPropertyName]
+        - Location (if appropriate) type string
+        - Tag, type `HashTable`
+
+### Parameters and the Pipeline
+- [ ] Complex parameters should take values from the pipeline when possible, and certainly when they match the output type of another cmdlet
+- [ ] Only one parameter should use ValueFromPipeline per parameter set; parameters from different parameter sets may have this attribute, but should not be convertible
+- [ ] No parameter is of type `object`
+- [ ] Each management cmdlet should have a parameter set that takes `ResourceGroupName` and `Name` from the pipeline by property value
+- [ ] For a given resource type, it should be possible to pipe the output of `Get` and `New` cmdlets to the input of `Set`, `Update`, `Remove` and other action cmdlets for that resource

build.proj

@@ -257,7 +257,9 @@
         ExpectedDelaySigned="false"
         ContinueOnError="false" 
         Condition="!$(DelaySign) and '@(DelaySignedAssembliesToSign)' != ''"/>
-        
+    
+    <Exec Command="$(PowerShellCommand) -NonInteractive -NoLogo -NoProfile -Command &quot;. $(LibraryToolsFolder)\CheckStrongNameSignature.ps1 &quot;"/>
+
     <!-- Copying signed shortcut back -->
     <Copy SourceFiles="$(LibrarySourceFolder)\Package\$(Configuration)\AzureRM.psd1" 
       DestinationFolder="$(LibraryRoot)tools\AzureRM" />

documentation/breaking-change-template.md

@@ -0,0 +1,27 @@
+## Breaking Change Title
+
+The following cmdlets were affected this release:
+
+**Cmdlet-1**
+- Description of what has changed
+
+```powershell
+# Old
+# Sample of how the cmdlet was previously called
+
+# New
+# Sample of how the cmdlet should now be called
+```
+
+**Cmdlet-2**
+- Description of what has changed
+
+```powershell
+# Old
+# Sample of how the cmdlet was previously called
+
+# New
+# Sample of how the cmdlet should now be called
+```
+
+For an example migration guide for breaking changes, click [here](release-notes/migration-guide.2.0.0.md).