search

Azure / azure-sdk-for-net

This repository is for active development of the Azure SDK for .NET. For consumers of the SDK we recommend visiting our public developer docs at https://learn.microsoft.com/dotnet/azure/ or our versioned developer docs at https://azure.github.io/azure-sdk-for-net.
MIT License
5.18k stars 4.54k forks source link

[BUG] The documentation doesn't document anything. Specifically Azure AD access. #36546

Closed Neutrino-Sunset closed 1 year ago

Neutrino-Sunset commented 1 year ago

Library name and version

Microsoft.Azure.Management.Graph.RBAC.Fluent 1.38.1

Describe the bug

The Azure SDK document home page is here https://learn.microsoft.com/en-us/dotnet/azure/sdk/azure-sdk-for-dotnet

Nothing in this entire documentation says anything about accessing the Azure AD. None of the samples linked from here do anything with the Azure AD apart from basic authentication.

The Azure SDK API reference is here https://learn.microsoft.com/en-us/dotnet/api/overview/azure/?view=azure-dotnet&preserve-view=true

None of the overviews for any of the libraries provide any overview of what the library is actually for. The overview for Azure Graph RBAC literally just repeats the name of the library

image

The package link on the overview page links to a NuGet page that says "this package is being phased out, please see https://aka.ms/azsdk/dotnet/mgmt" and the link doesn't describe what it's being replaced with.

I want to access ServicePrincipal information in order to check for credentials that are near to expiring. Something that can be done using the PowerShell cmdlet Get-MsolServicePrincipal. How do I do this using the SDK? After two days of searching I haven't found anything remotely useful.

The documentation for this entire SDK is worse than anything I have ever seen.

Expected behavior

I would expect the documentation to describe what the various libraries do and how to use them.

Actual behavior

The documentation is just useless lists of package and method names.

Reproduction Steps

Open the docuentation here https://learn.microsoft.com/en-us/dotnet/azure/sdk/azure-sdk-for-dotnet

Now try and work out how to get information about Identity Objects in the Azure Directory.

Good luck with that.

Environment

No response

jsquire commented 1 year ago

Thank you for your feedback. Tagging and routing to the team member best able to assist.

ArthurMa1978 commented 1 year ago

Hey @Neutrino-Sunset this sdk is being deprecated, please to Microsoft.Graph and here is the new document site.

github-actions[bot] commented 1 year ago

Hi @Neutrino-Sunset. Thank you for opening this issue and giving us the opportunity to assist. To help our team better understand your issue and the details of your scenario please provide a response to the question asked above or the information requested above. This will help us more accurately address your issue.

github-actions[bot] commented 1 year ago

Hi @Neutrino-Sunset, we're sending this friendly reminder because we haven't heard back from you in 7 days. We need more information about this issue to help address it. Please be sure to give us your input. If we don't hear back from you within 14 days of this comment the issue will be automatically closed. Thank you!

github-actions[bot] commented 1 year ago

Hi @Neutrino-Sunset, we're sending this friendly reminder because we haven't heard back from you in 7 days. We need more information about this issue to help address it. Please be sure to give us your input. If we don't hear back from you within 14 days of this comment the issue will be automatically closed. Thank you!

github-actions[bot] commented 1 year ago

Hi @Neutrino-Sunset, we're sending this friendly reminder because we haven't heard back from you in 7 days. We need more information about this issue to help address it. Please be sure to give us your input. If we don't hear back from you within 14 days of this comment the issue will be automatically closed. Thank you!