msgraph-sdk-powershell icon indicating copy to clipboard operation
msgraph-sdk-powershell copied to clipboard

Release cycle of MS Graph PS modules should be documented

Open adamedx opened this issue 2 years ago • 2 comments

Users ask questions like the following which could be solved by documenting the release frequency of the ms graph ps modules to PowerShell Gallery:

  • How often is MS Graph PS updated (i.e. daily, weekly, monthly, etc.)?
  • When will new API xxxx show up in MS Graph PS in PowerShell Gallery?
  • What should I do if I don't see a command that I expect to be present in MS Graph PS?

Opportunities for documenting this include:

  • The overview article, in particular the "Features" section could include the fact that new commands for APIs are released at frequency X as a "feature": https://docs.microsoft.com/en-us/powershell/microsoftgraph/overview?view=graph-powershell-beta
  • The installation section, which could include a recommendation to use the Update-Module commands with some frequency as a way to keep up with the latest commands
  • Any troubleshooting articles where the topic of "what if I can't find a command" comes up
  • The section on using Find-MgGraphCommand could note that updating to the latest microsoft.graph.authentication is required for the command to be accurate, and note the release cycle for emphasis.

adamedx avatar Jun 06 '22 15:06 adamedx

I +1 this.

This is particullarly interessting when there is a bug fix in the pipeline (e.g. #1185 which was closed with #1303) but is not in a release build yet.

This would help Projects with planning when relying on such bug fix or on other new features as described by OG.

MichaMican avatar Jun 13 '22 09:06 MichaMican

Hi @adamedx and @MichaMican - this isn't exactly the answer to this issue, but something I only thought to do recently was to 'watch' the msgraph-sdk-powershell repo and set the notifications to at least Custom and include New Releases in the list of things that prompt a notification.

It's one easy way to see when a new version is out. So if/when you know there's a bug that is due to be fixed in the next release, at least you can know you'll know when that release comes out.

JeremyTBradshaw avatar Jul 11 '22 11:07 JeremyTBradshaw