dotnet / dotnet/dotnet-api-docs

Add example for new API that creates directory with ACLs

Offen
#3,373 0 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen
area-System.IO doc-enhancement example-request Pri3
Vorherrschende Sprache
C#
Sterne
950
Forks
1.7k
Ø Merge
2 T. 19 Std.
Gemergte PRs (30 T.)
52

Beschreibung

[This issue ](https://github.com/dotnet/corefx/issues/41614)tracks the proposal of APIs to create directories and files ensuring the passed ACLs are set on creation.

We already have [an example](https://docs.microsoft.com/en-us/dotnet/api/system.io.directoryinfo.setaccesscontrol?view=netframework-4.8#examples) in Docs that explains how to set ACLs on directories.

After merging [this PR](https://github.com/dotnet/corefx/pull/41834/files), and adding the new API to dotnet-api-docs, we need a code example to use it.

We can base the example on the unit tests I am adding.

CC @mairaw @JeremyKuhne

Beitragsleitfaden

Beitragsleitfaden öffnen

Rechercherichtung

Lesen Sie den verlinkten API-Vorschlag, das vorhandene Dokumentationsbeispiel für DirectoryInfo.SetAccessControl und die in der Issue erwähnten Unit-Tests. Nachdem die neue API in dotnet-api-docs verfügbar ist, fügen Sie ein Codebeispiel hinzu, das die Erstellung eines Verzeichnisses mit ACLs zeigt, und überprüfen Sie, dass das Beispiel dem Verhalten der API und den Dokumentationskonventionen entspricht.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Tech-Stack
csharp
Bereich
documentation
Issue-Typ
Dokumentation
Schwierigkeit
2/5
Geschätzter Aufwand
1-3 Stunden
Aktivitätsstatus
Veraltet
Klarheit
Größtenteils klar
Anfängerfreundlichkeit
52/100

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.