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

Update packaging guidelines cont #14339

Merged
merged 9 commits into from
Oct 10, 2019

Conversation

tmds
Copy link
Member

@tmds tmds commented Sep 10, 2019

This addresses comments #13196 (comment) and below.

@omajid @dagood ptal

cc @leecow

@tmds tmds requested a review from mairaw as a code owner September 10, 2019 07:30
Copy link
Member

@dagood dagood left a comment

Choose a reason for hiding this comment

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

Seems reasonable, a couple suggestions.

@mairaw mairaw requested a review from leecow September 11, 2019 00:16
@mairaw mairaw added this to the September 2019 milestone Sep 11, 2019
@tmds
Copy link
Member Author

tmds commented Sep 16, 2019

All review comments addressed. @dagood @omajid can you approve the PR if it is good for merging?

Copy link
Member

@dagood dagood left a comment

Choose a reason for hiding this comment

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

One minor suggestion (section move) and one comment, LGTM either way though.

@@ -171,6 +171,8 @@ Most distributions require all artifacts to be built from source. This has some

Multiple `dotnet-sdk` packages may provide the same files for the `NuGetFallbackFolder`. To avoid issues with the package manager, these files should be identical (checksum, modification date, and so on).

The folders marked with `(*)` are used by multiple packages. Some package formats (e.g. `rpm`) require special handling of such folders. The package maintainer must take care of this.
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 should be at the end of the Disk layout section instead, had a hard time finding it so far away from the table.

Copy link
Member Author

Choose a reason for hiding this comment

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

moving this up

@@ -171,6 +171,8 @@ Most distributions require all artifacts to be built from source. This has some

Multiple `dotnet-sdk` packages may provide the same files for the `NuGetFallbackFolder`. To avoid issues with the package manager, these files should be identical (checksum, modification date, and so on).

The folders marked with `(*)` are used by multiple packages. Some package formats (e.g. `rpm`) require special handling of such folders. The package maintainer must take care of this.
Copy link
Member

Choose a reason for hiding this comment

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

It would be nice to have this described somewhere... but this note LGTM--hard to make it clear to readers not already familiar with this requirement without putting a lot more info in this doc and probably cluttering it up. Selfishly, I'd like to get the Microsoft RPMs up to snuff, and know what the consequences are of getting it wrong.

Copy link
Member Author

Choose a reason for hiding this comment

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

Yes, we can assume that the package maintainer knows what this is about.

Copy link
Member

@omajid omajid left a comment

Choose a reason for hiding this comment

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

LGTM. Thanks!

@tmds
Copy link
Member Author

tmds commented Sep 18, 2019

@mairaw, based on @dagood and @omajid review, this is good for merging.

@omajid @dagood thanks for all your feedback to get this together!

Copy link
Contributor

@mairaw mairaw 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 @tmds. Left a few comments, some unrelated to your changes. @leecow @jamshedd can one of you review this as well?

@leecow
Copy link
Member

leecow commented Oct 4, 2019

Thank you @tmds. Left a few comments, some unrelated to your changes. @leecow @jamshedd can one of you review this as well?

Suggested edits look good.

@mairaw
Copy link
Contributor

mairaw commented Oct 10, 2019

I've applied the suggestions so we can get this merged. Thanks so much @tmds!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants