Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add package readmes to shipping libraries packages #99358

Open
ViktorHofer opened this issue Mar 6, 2024 · 2 comments
Open

Add package readmes to shipping libraries packages #99358

ViktorHofer opened this issue Mar 6, 2024 · 2 comments
Labels
area-Meta documentation Documentation bug or enhancement, does not impact product or test code help wanted [up-for-grabs] Good issue for external contributors
Milestone

Comments

@ViktorHofer
Copy link
Member

ViktorHofer commented Mar 6, 2024

Continuation of #91210 & #92228

This issue tracks adding the remaining 30 package readmes to our shipping libraries packages.

One of the top customer problems that package consumers are facing is lack of documentation. As such, we are driving an effort to increase the adoption and quality of NuGet package READMEs.

Ask

To lead by example and ensure that our packages have the maximum impact, we would greatly appreciate your support in increasing the adoption and quality of NuGet package READMEs.

Why

The README file is an essential part of your package as it provides important information to users and helps them understand what the package is and what it does quickly. Also, README is the first things for users when they view your package on NuGet.org and soon other tooling, it is crucial for package authors to write and include high-quality READMEs for their packages.

How

This issue lists all the remaining package that are missing package READMEs. Feel free to submit a PR that targets the main branch by using the NEW link from the table below. For a great example, please see System.Text.Json's package README. Expect to spend ~15-30min of your time per README. Please try to keep documentation as minimal as possible to avoid duplicating information that is already available on docs.microsoft.com.

Packages

This list is sorted alphabetically.

Package Status Owner
Microsoft.Bcl.Memory New
Microsoft.Extensions.DependencyInjection.Specification.Tests New
Microsoft.Extensions.Diagnostics New @tommcdon
Microsoft.Extensions.Diagnostics.Abstractions New @tommcdon
Microsoft.Extensions.FileProviders.Composite New @jeffhandley
Microsoft.Extensions.Logging.Configuration New @ericstj
Microsoft.Extensions.Logging.EventLog New @ericstj
Microsoft.Extensions.Logging.EventSource New @ericstj
Microsoft.NET.WebAssembly.Threading New @lewing
Microsoft.XmlSerializer.Generator New @HongGit
System.CodeDom New
System.ComponentModel.Composition New @ericstj
System.ComponentModel.Composition.Registration New @ericstj
System.Composition New
System.Composition.AttributedModel New
System.Composition.Convention New
System.Composition.Hosting New
System.Composition.Runtime New
System.Composition.TypedParts New
System.Diagnostics.DiagnosticSource New @tommcdon
System.Formats.Asn1 New
System.Formats.Nrbf New
System.IO.Packaging New @ericstj
System.Reflection.Context New
System.Resources.Extensions New @ericstj
System.Runtime.Serialization.Schema New @HongGit
System.Security.Cryptography.Cose New @jeffhandley
System.Security.Cryptography.Pkcs New @jeffhandley
System.Security.Cryptography.Xml New @jeffhandley
System.Security.Permissions New @jeffhandley

FWIW I created this table via the following code: https://gist.github.com/ViktorHofer/e4ba1766b7ee751261515781e7bb5927

✅ (:white_check_mark:) ->merged

🕜 (:clock130:) -> under review

cc @lyndaidaii @ericstj @artl93 @eNeRGy164

@ghost
Copy link

ghost commented Mar 6, 2024

Tagging subscribers to this area: @dotnet/area-infrastructure-libraries
See info in area-owners.md if you want to be subscribed.

Issue Details

Continuation of #91210 & #92228

This issue tracks adding the remaining package readmes to our shipping libraries packages.

Author: ViktorHofer
Assignees: -
Labels:

area-Infrastructure-libraries

Milestone: 9.0.0

@eNeRGy164
Copy link
Contributor

@ViktorHofer #106344 for System.Formats.Nrbf

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area-Meta documentation Documentation bug or enhancement, does not impact product or test code help wanted [up-for-grabs] Good issue for external contributors
Projects
None yet
Development

No branches or pull requests

3 participants