Skip to content
New issue

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

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

Already on GitHub? # to your account

Include the README in Autofac NuGet packages #1295

Closed
tillig opened this issue Nov 18, 2021 · 0 comments · Fixed by #1308
Closed

Include the README in Autofac NuGet packages #1295

tillig opened this issue Nov 18, 2021 · 0 comments · Fixed by #1308

Comments

@tillig
Copy link
Member

tillig commented Nov 18, 2021

Problem Statement

As of .NET 5 / NuGet 5.10.0 preview 2, you can include your README in the NuGet package to get something richer showing up on the NuGet.org site. Without that, you just get the package description and it looks very sad and lonely in there.

Desired Solution

  • Update the README to make sure it works both on the GitHub site and on NuGet.org. I'm not sure I can quantify everything, but, for example...
    • Links to things probably need to be absolute instead of relative to the GitHub repo.
    • Only use the image sources and markdown features they support. Double check that things like badges and the 'Open in VS Code' thing are all on the approved list and are using full URLs.
  • Update the .csproj as shown in the instructions to include the README.
  • Possibly test this using a manual upload first, to see what it's going to look like. They talk about how to do that on the NuGet.org site. We don't want to iterate over this by actually releasing a bunch of packages.

I don't think this is worth pushing a whole new version for. I think we should just get it ready and then when the next release goes out, this will just be there.

If there are other packages going out sooner, it might be worth doing those first so we get some experience.

# for free to join this conversation on GitHub. Already have an account? # to comment
Projects
None yet
1 participant