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

Clarify contribution for main-distribution packages #3991

Merged
merged 1 commit into from
Sep 17, 2021

Conversation

jryans
Copy link
Member

@jryans jryans commented Sep 10, 2021

This extends the contribution guide for main-distribution packages to describe two separate workflows

  1. Release / snapshot
  2. In-place build

each of which needs slightly different commands.

@shhyou shhyou added the documentation Issues related to README and documentation (typos, rewording, new docs, etc) label Sep 10, 2021
Copy link
Member

@mflatt mflatt left a comment

Choose a reason for hiding this comment

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

Thanks for this improvement! I have one request for a wording change.

To start working on a package @nonterm{pkg-name}, it's usually best to
go to the root directory of your Racket repository checkout and run
To start working on a package @nonterm{pkg-name} from a Racket release
or snapshot, you first need to edit the package's catalog
Copy link
Member

Choose a reason for hiding this comment

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

"edit the package's catalog" is not quite right here. This should be something like "adjust the package installation to use the source specified by the main package catalog".

Copy link
Member Author

Choose a reason for hiding this comment

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

Ah thanks, that's a better description of what's happening. 😄 I have updated this to match your wording.

This extends the contribution guide for `main-distribution` packages to describe
two separate workflows

1. Release / snapshot
2. In-place build

each of which needs slightly different commands.
@jryans
Copy link
Member Author

jryans commented Sep 17, 2021

@mflatt Thanks for taking a look, review comment addressed. 🙂 Someone will need to re-approve the workflows if a fresh CI pass is desired before merging.

@mflatt mflatt merged commit 92de0d2 into racket:master Sep 17, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Issues related to README and documentation (typos, rewording, new docs, etc)
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants