Skip to content

Update README and CONTRIBUTING guidelines#98

Draft
ioreka wants to merge 6 commits into
mainfrom
update-contributing-and-readme
Draft

Update README and CONTRIBUTING guidelines#98
ioreka wants to merge 6 commits into
mainfrom
update-contributing-and-readme

Conversation

@ioreka
Copy link
Copy Markdown

@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
Comment thread CONTRIBUTING.md Outdated
Comment thread CONTRIBUTING.md Outdated
Comment thread CONTRIBUTING.md Outdated
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)
Comment thread CONTRIBUTING.md
Markdown files are linted by
[`markdownlint-cli`](https://github.com/igorshubovych/markdownlint-cli).
```sh
make prettier_check
Copy link
Copy Markdown
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.
Comment thread CONTRIBUTING.md
npm install -g prettier@3.0.0
prettier --version

Once installed, ensure your editor runs Prettier on a pre-save hook:
Copy link
Copy Markdown
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