Improve documentation with more examples

[PalmEmanuel]

Examples of more use cases would be good, for example when working with multiple resources in the same script or session. How to get multiple tokens with only one interactive auth etc.

[m-hanisch]

@PalmEmanuel
Would you consider to add two of your very own related blog articles as RELATED LINKS to the Get-AzToken cmdlet help file?
Maybe also add a hint to the second link in the description of the switch parameter -WorkloadIdentity?

• OAuth 2.0 Fundamentals for Azure APIs
• Azure Workload Identity Federation

Especially the second one is a valuable source of information when using the Get-AzToken cmdlet with the -WorkloadIdentity switch parameter.
I tried to figure out how to contribute to your repo myself. However, I do not feel comfortable enough how to proceed if I want to update an existing .md help file.
Simply editing the .md file? Or using Update-MarkdownHelp?

[PalmEmanuel]

@PalmEmanuel
Would you consider to add two of your very own related blog articles as RELATED LINKS to the Get-AzToken cmdlet help file?
Maybe also add a hint to the second link in the description of the switch parameter -WorkloadIdentity?

• OAuth 2.0 Fundamentals for Azure APIs
• Azure Workload Identity Federation

Especially the second one is a valuable source of information when using the Get-AzToken cmdlet with the -WorkloadIdentity switch parameter.
I tried to figure out how to contribute to your repo myself. However, I do not feel comfortable enough how to proceed if I want to update an existing .md help file.
Simply editing the .md file? Or using Update-MarkdownHelp?

That's a very good idea, I'll be sure to do that!

[PalmEmanuel]

Added blog links, thanks for the suggestion @m-hanisch! It will show up in the next release 👍

[m-hanisch]

@PalmEmanuel
You can close this issue. Just double checked that you implemented the Related links.
Best regards :)

[PalmEmanuel]

I'll leave it open for now I think, thanks for verifying though!

Still some improvement to be made in the overall documentation 👍