Skip to content

chore: Update contributing guide about commits #1870

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

Merged
merged 2 commits into from
May 19, 2025

Conversation

Laubi
Copy link
Contributor

@Laubi Laubi commented Apr 30, 2025

What this PR does / Why we need it:

Updates the contributing guide to specify what conventional-commit prefixes are available, and when to use which one.

Special notes for your reviewer:

I started also updating the contribution guide in regard to the "how to run tests" and "how to build monaco" sections, but stopped myself, in case it's worse then before. This is the 2nd commit. If we want to have it in, we can adopt it, otherwise I have no issues in dropping the 2nd commit.

@Laubi Laubi requested a review from a team as a code owner April 30, 2025 12:47
CONTRIBUTING.md Outdated
```
feat: allow provided config object to extend other configs
```
[Conventional commit]: https://www.conventionalcommits.org/
Copy link
Contributor

Choose a reason for hiding this comment

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

Conventional starts with an upper-case here, whereas the other bullet points don't.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Conventional Commits is written uppercase: https://www.conventionalcommits.org/en/v1.0.0/
I updated Commit to also be uppercase, as both are also written in uppercase on the webpage.

Also, just to be sure if you are not aware of them, these are not bullet points, but Reference-style Links where they are replaced above in the text (L#49)

### Building Monaco
To build Monaco, execute the following command in the repository root folder:
```shell
go build ./cmd/monaco
Copy link
Contributor

Choose a reason for hiding this comment

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

make build and other targets reference generating mocks, which is left out here with no replacement and could lead to confusion when building/running tests/...

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Building Monaco should be independent of the mocks, testing is just not.
I added the info to the Testing .... header.

@Laubi Laubi force-pushed the chore/update-contributing-guide branch 2 times, most recently from 2c6aed3 to 1ce8cca Compare May 14, 2025 11:26
@tomazpu tomazpu force-pushed the chore/update-contributing-guide branch from 1ce8cca to 53d5eb8 Compare May 15, 2025 10:50
Laubi added 2 commits May 19, 2025 15:40
Update the 'building/running' section of the contrib guidelines to ditch the Makefile.
@Laubi Laubi force-pushed the chore/update-contributing-guide branch from 53d5eb8 to 6a142c0 Compare May 19, 2025 13:40
@Laubi Laubi merged commit 4f5810e into main May 19, 2025
10 checks passed
@Laubi Laubi deleted the chore/update-contributing-guide branch May 19, 2025 13:43
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.

3 participants