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 readme to nuget #2282

Merged
merged 10 commits into from
Mar 28, 2024
Merged

Add readme to nuget #2282

merged 10 commits into from
Mar 28, 2024

Conversation

Ellerbach
Copy link
Member

@Ellerbach Ellerbach commented Feb 19, 2024

  • Add readme to nuget
  • Correct few links on existing readme
Microsoft Reviewers: Open in CodeFlow

@@ -27,6 +27,7 @@
</ItemGroup>
<ItemGroup>
<ProjectReference Include="$(MainLibraryPath)System.Device.Gpio.csproj" />
<Content Include="$(RepoRoot)src/device/README-nuget.md" Pack="true" PackagePath="\README.md" />
Copy link
Member

Choose a reason for hiding this comment

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

I think this is not enough. This will make it so that the README itself is in the package, but it won't set the right things in the nuspec so that it shows up in NuGet.org or Visual Studio. For that, we should also set PackageReadmeFile. It is also tipically suggested to not use content item for things that do not go into content/ folder in the package, so we should probably use None instead. Here is the blog post where the NuGet team announced how to add Readme files to packages: https://devblogs.microsoft.com/nuget/add-a-readme-to-your-nuget-package/

Copy link
Member Author

Choose a reason for hiding this comment

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

So, I adjusted everything, a checked the presence in the nuspec, can't really check the very final element but I think it should be ok according to the test I've been doing on a personal project.

@krwq
Copy link
Member

krwq commented Feb 29, 2024

/azp run

Copy link

Azure Pipelines successfully started running 1 pipeline(s).

@krwq krwq merged commit fd5e68b into dotnet:main Mar 28, 2024
10 checks passed
@github-actions github-actions bot locked and limited conversation to collaborators Apr 28, 2024
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants