SovereignCloudStack / SovereignCloudStack/docs
Pre-commit hooks need more documentation
@maxwolfs is already working on this.
Since Jan 23, 2025.
- Dominant language
- JavaScript
- Stars
- 18
- Forks
- 10
- Avg merge
- 15h 16m
- Merged PRs (30d)
- 2
Description
As mentioned in https://github.com/SovereignCloudStack/docs/issues/287#issuecomment-2606535752 (point 4), commits are not working without further work.
(a) https://docs.scs.community/community/contribute/linting-guide/ says that husky, prettier and markdownlint-cli2 are being used. Following the links and following the install instructions means installing npm install --save-dev husky (which is harmless), npm install --save-dev --save-exact prettier (which pulls in a few dozen dependencies and may not be as harmless) and npm install --save-dev markdownlint-cli2 (not exatcly harmless either) . Explicitly mentioning that those two npm packages need to be installed (maybe best into a container) would be good.
(b) It still does not work as is, as the docs repo has this
#!/bin/sh
. "$(dirname "$0")/_/husky.sh"
in .husky/pre-commit
This file does not exist in git. I created an empty one to make commits work, but this is likely not how it's supposed to be done ...
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.