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 README with PR testing process & yarn dependency mgmt notes #231

Merged
merged 2 commits into from
Mar 6, 2018

Conversation

tdonohue
Copy link
Member

@tdonohue tdonohue commented Mar 2, 2018

Per our meeting last week, I've updated the README with:

  • Add Notes on how to easily test PRs
  • Enhance notes on properly managing our dependencies via yarn
  • Minor formatting fixes to other sections

@artlowel , could you give this a quick review to ensure it looks correct?

@tdonohue tdonohue requested a review from artlowel March 2, 2018 17:10
@ghost ghost assigned tdonohue Mar 2, 2018
@ghost ghost added the needs review label Mar 2, 2018
README.md Outdated
yarn creates the file [`yarn.lock`](https://yarnpkg.com/en/docs/yarn-lock) to track those versions. That file is updated automatically every time you install a new dependency from the commandline (by using `yarn add some-lib --save` or `yarn add some-lib --save-dev`).
* `yarn` creates a [`yarn.lock`](https://yarnpkg.com/en/docs/yarn-lock) to track those versions. That file is updated automatically by whenever dependencies are added/updated/removed via yarn.
* **Adding new dependencies**: To install/add a new dependency (third party library), use [`yarn add`](https://yarnpkg.com/en/docs/cli/add). For example: `yarn add some-lib --save`.
* If it's a development-only dependency (not for production), use `yarn add some-lib --save-dev`
Copy link
Member

Choose a reason for hiding this comment

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

If it's a development-only dependency (not for production)

This is more about build tools vs dependencies, rather than development vs production. Dependencies that are only needed to build the project like a typescript compiler, or webpack (an analogy with dspace's java code would be maven or ant) are dev dependencies, while things that need to end up in the built code, like angular itself, or bootstrap (for java: apache.commons, or solr) are regular dependencies.

Copy link
Member Author

Choose a reason for hiding this comment

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

Thanks for the notes, @artlowel . I've updated the README to clarify, and also rebased on master (so that the Travis build errors go away)

@artlowel artlowel merged commit 605c352 into master Mar 6, 2018
@ghost ghost removed the needs review label Mar 6, 2018
@tdonohue tdonohue deleted the update-README branch March 6, 2018 21:17
@tdonohue tdonohue added this to the 7.0preview milestone Jan 26, 2021
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.

2 participants