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 and CONTRIBUTING guidelines #98

Draft
wants to merge 6 commits into
base: main
Choose a base branch
from

Conversation

ioreka
Copy link

@ioreka ioreka commented Jan 6, 2025

  1. Update jobs link from Octopus Energy (deprecated) to Kraken
  2. Improve the contribution guidelines as they are a little outdated

@ioreka ioreka mentioned this pull request Jan 6, 2025
Splitting into sections and including a clear Installation section
CONTRIBUTING.md Outdated Show resolved Hide resolved
CONTRIBUTING.md Outdated Show resolved Hide resolved
CONTRIBUTING.md Outdated Show resolved Hide resolved
ioreka and others added 3 commits January 6, 2025 13:16
This commit:

- Ensures all contributing instructions now work
- Upgrades Prettier to v3.2.5 (and fixes the related issues)
Markdown files are linted by
[`markdownlint-cli`](https://github.com/igorshubovych/markdownlint-cli).
```sh
make prettier_check
Copy link
Author

@ioreka ioreka Jan 9, 2025

Choose a reason for hiding this comment

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

I get a really long output of [warn]s for this that i am reluctant to fix:
image
Not sure if that's the desired outcome

While troubleshooting the docker daemon issues in the spelling and linting commands, I discovered a missing step for users who (like me) did not have Docker already installed (https://stackoverflow.com/questions/44084846/cannot-connect-to-the-docker-daemon-on-macos). The easiest docs amend was to advise installing the app and having an account.

npm install -g [email protected]
prettier --version

Once installed, ensure your editor runs Prettier on a pre-save hook:
Copy link
Author

Choose a reason for hiding this comment

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

I see pre-save hook in the cookie-cutter repo too but my Google-fu must be weak because I can't find this term. Is this another way of phrasing eg. Prettier running locally in your IDE when you save?

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