msgraph-sdk-powershell
msgraph-sdk-powershell copied to clipboard
Release cycle of MS Graph PS modules should be documented
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 latestmicrosoft.graph.authentication
is required for the command to be accurate, and note the release cycle for emphasis.
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.
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.