Skip to content

Conversation

@eNeRGy164
Copy link
Contributor

Fill out details for the System.DirectoryServices.Protocols NuGet package readme.

See #92228

@ghost ghost added community-contribution Indicates that the PR has been added by a community member area-System.DirectoryServices labels Oct 14, 2023
@ghost
Copy link

ghost commented Oct 14, 2023

Tagging subscribers to this area: @dotnet/area-system-directoryservices, @jay98014
See info in area-owners.md if you want to be subscribed.

Issue Details

Fill out details for the System.DirectoryServices.Protocols NuGet package readme.

See #92228

Author: eNeRGy164
Assignees: -
Labels:

area-System.DirectoryServices, community-contribution

Milestone: -

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
It primarily utilizes the `LdapConnection` type for interacting with LDAP servers, utilizing system native libraries to establish TCP/IP or UDP LDAP connections.
It primarily uses the `LdapConnection` type for interacting with LDAP servers, using system native libraries to establish TCP/IP or UDP LDAP connections.

Pet peeve 😀

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Would using be better

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I was doubting about that, this makes it quite explicit that you should dispose, and I think the new way of using without {} is not recognizable enough.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Initially supporting only Windows, the assembly now also supports Unix environments, although not yet achieving feature parity between the two.
Supports Windows and Unix, although some features are not supported on Unix.

Would it be helpful to list some features that aren't available on Unix?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I have to rely on the source code and documentation, and they are quite sparse. I found some comments on client and server cert options, added that as suggestion.

@danmoseley
Copy link
Member

Thanks @eNeRGy164

@eNeRGy164 eNeRGy164 force-pushed the system-directory-services-protocols branch from e44b388 to cb58bb9 Compare October 15, 2023 20:49
Copy link
Member

@danmoseley danmoseley left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good to me but owner of the area should sign off (and confirm code sample)

@danmoseley
Copy link
Member

Feel like doing more of the package readmes? Now you got warmed up 😀

@eNeRGy164
Copy link
Contributor Author

Feel like doing more of the package readmes? Now you got warmed up 😀

#93485, #93489, #93516 😝

@danmoseley
Copy link
Member

Oh, whoops 🙂

@ViktorHofer
Copy link
Member

@dotnet/area-system-directoryservices please review this package readme PR before EOW so that we can get the change still ported into .NET 8.

Copy link
Contributor

@buyaa-n buyaa-n left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you @eNeRGy164, left a comment, overall LGTM

@eNeRGy164 eNeRGy164 force-pushed the system-directory-services-protocols branch from cb58bb9 to 2cdb91b Compare October 17, 2023 18:51
@buyaa-n
Copy link
Contributor

buyaa-n commented Oct 17, 2023

The failure unrelated and doesn't seem actionable.

@buyaa-n buyaa-n merged commit fc48802 into dotnet:PackageReadmesContinued Oct 17, 2023
@eNeRGy164 eNeRGy164 deleted the system-directory-services-protocols branch October 18, 2023 05:29
@ghost ghost locked as resolved and limited conversation to collaborators Nov 17, 2023
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

area-System.DirectoryServices community-contribution Indicates that the PR has been added by a community member

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants