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 CONTRIBUTING.md #7473

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 6 additions & 6 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Contributing to Jupyter Notebook

Thanks for contributing to Jupyter Notebook!
Thanks for showing interest on contributing to Jupyter Notebook!
Copy link
Member

Choose a reason for hiding this comment

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

This sounds like bad grammar to me, there is only one result on Google for "Thanks for showing interest on contributing to".


Make sure to follow [Project Jupyter's Code of Conduct](https://github.com/jupyter/governance/blob/master/conduct/code_of_conduct.md)
for a friendly and welcoming collaborative environment.
Expand Down Expand Up @@ -35,7 +35,7 @@ jlpm develop
jupyter server extension enable notebook
```

`notebook` follows a monorepo structure. To build all the packages at once:
`notebook` follows a monorepo structure. To build all the packages at once use:

```bash
jlpm build
Expand Down Expand Up @@ -72,7 +72,7 @@ jupyter notebook

### Local changes in Notebook dependencies

The development installation described above fetches JavaScript dependencies from [npmjs](https://www.npmjs.com/),
The developmental installations described above fetches JavaScript dependencies from [npmjs](https://www.npmjs.com/),
Copy link
Member

Choose a reason for hiding this comment

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

Both "developmental" and "installations" sound incorrect in this context.

according to the versions in the _package.json_ file.
However, it is sometimes useful to be able to test changes in Notebook, with dependencies (e.g. `@jupyterlab` packages) that have not yet
been published.
Expand All @@ -92,7 +92,7 @@ Notebook, acting as a local package repository.
With the previous example, it would be `yalc add @jupyterlab/ui-components`.
- Notebook is a monerepo, so we want this dependency to be 'linked' as a resolution (for all sub-packages) instead
of a dependency.\
The easiest way is to manually move the new entry in _package.json_ from _dependencies_ to _resolutions_.
The easiest way is to do it is manually move the new entry in _package.json_ from _dependencies_ to _resolutions_.
Copy link
Member

Choose a reason for hiding this comment

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

The existing text sounds fine to me.

- Build Notebook with the local dependency:\
`jlpm install && jlpm build`

Expand Down Expand Up @@ -199,8 +199,8 @@ You can invoke the pre-commit hook by hand at any time with:
pre-commit run
```

which should run any autoformatting on your code
and tell you about any errors it couldn't fix automatically.
Which should run any autoformatting on your code
Copy link
Member

Choose a reason for hiding this comment

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

This is continuation of previous sentence so was right to my eye

and tell you about any errors that it couldn't fix automatically.
You may also install [black integration](https://github.com/psf/black#editor-integration)
into your text editor to format code automatically.

Expand Down
Loading