Skip to content

Welcome On board New RP with PowerShell Generator

Jump to bottom
Xiaogang edited this page Mar 31, 2020 · 1 revision

There are three key steps for on-boarding a new RP with AutoRest PowerShell Generator.

  • Onboard request
  • Design review
  • PR review

Onboard Request

The first step is to send an onboard request to Azure PowerShell PM Damien(dcaro@microsoft.com). And you are expected to provide information as below(maybe more).

  • RP status
  • Roadmap
  • Contact person for customer support

Damien will assist you to work out a speclet for your RP, which is something like combination of use-case spec and function spec.

Design Review

Based on the speclet, you may start to generate code. Detailed steps are below.

  • Generate code with PowerShell generator
  • Customize code based on the speclet
  • Write examples

When all above steps are completed, you may file a ticket in https://github.com/Azure/azure-powershell-cmdlet-review-pr/issues for design review. The issue should contain content below.

  • Link to the speclet
  • Cmdlets syntax and examples (you may copy and paste them from the ./docs folder)
  • A link to the code repo which contains the docs folder

The issue will be assigned to an engineer in Azure PowerShell team for review. If the RP is complex, a review meeting will be needed, otherwise, review may be done through comments in the ticket/emails.

Code Review

When design review is ongoing, you may write the test cases. After design review passes, you could file a PR against the generation branch of azure-powershell for code review. And code list is as following.

  • readme.md
  • custom
  • examples
  • test
  • docs

After code review, congratulaitions, you got the chance to take the release train, which is once every three week.

Clone this wiki locally