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

Using NPM vs Yarn to build docs #988

Open
kamilprz opened this issue Nov 11, 2024 · 2 comments
Open

Using NPM vs Yarn to build docs #988

kamilprz opened this issue Nov 11, 2024 · 2 comments
Assignees
Labels
area/documentation Improvements or additions to documentation scope/S Change is Small type/fix Fixes something

Comments

@kamilprz
Copy link
Contributor

Within site/README.md it is mentioned to use Yarn for building docs locally, however, the make file uses npm.

In the project we have a package-lock.json which indicates that this project uses npm and ensures consistent installs across different environments. Yarn uses yarn.lock instead. Using both locks can lead to conflicts if they are out-of-sync.

We should remain consistent. Suggested change would be to remove the Yarn documentation.

@kamilprz kamilprz added area/documentation Improvements or additions to documentation scope/S Change is Small type/fix Fixes something labels Nov 11, 2024
@kamilprz kamilprz self-assigned this Nov 11, 2024
@timraymond
Copy link
Member

Agree that having both is a problem, but I'm surprised at the suggestion. I thought Yarn was better for many reasons (reproducibility, speed).

@kamilprz
Copy link
Contributor Author

The main reason for deleting Yarn docs is that it seems the repo is already set on using NPM. This can be seen in the Makefile under make docs and also by the fact that yarn.lock is actually already in the .gitignore (didn't realise this earlier).

Based on that it seems that the Yarn docs are just a remnant of the past.

github-merge-queue bot pushed a commit that referenced this issue Nov 26, 2024
# Description

Removing mention of Yarn from building docs, since npm is used instead.

## Related Issue

#988

## Checklist

- [x] I have read the [contributing
documentation](https://retina.sh/docs/contributing).
- [x] I signed and signed-off the commits (`git commit -S -s ...`). See
[this
documentation](https://docs.github.com/en/authentication/managing-commit-signature-verification/about-commit-signature-verification)
on signing commits.
- [x] I have correctly attributed the author(s) of the code.
- [x] I have tested the changes locally.
- [x] I have followed the project's style guidelines.
- [x] I have updated the documentation, if necessary.
- [ ] I have added tests, if applicable.

---

Please refer to the [CONTRIBUTING.md](../CONTRIBUTING.md) file for more
information on how to contribute to this project.

---------

Signed-off-by: Kamil <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area/documentation Improvements or additions to documentation scope/S Change is Small type/fix Fixes something
Projects
Status: No status
Development

No branches or pull requests

2 participants