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

docs: moved the policy regarding commits from when it was running locally to the contributor page #11701

Merged
merged 3 commits into from
Aug 30, 2023

Conversation

sunyeongchoi
Copy link
Member

@sunyeongchoi sunyeongchoi commented Aug 28, 2023

Fixes #11700

Motivation

Modifications

moved the policy regarding commits from when it was running locally to the contributor page and I have also improved some links related to commits

Verification

Comment on lines 62 to 66
TroubleShooting:

* When running `make pre-commit -B`, if you encounter errors like
`make: *** [pkg/apiclient/clusterworkflowtemplate/cluster-workflow-template.swagger.json] Error 1`, ensure that you
have checked out your code into `$GOPATH/src/github.com/argoproj/argo-workflows`.
Copy link
Member

Choose a reason for hiding this comment

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

But this pre-commit requires installing the toolchain which are listed in running-locally document.

Copy link
Contributor

Choose a reason for hiding this comment

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

Yea this may make more sense to just link out to running-locally.md#committing

Copy link
Member Author

Choose a reason for hiding this comment

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

@terrytangyuan @agilgur5

Thank you for your review! :)

Based on your feedback, I have kept the Committing-related information in the "running locally" file as is, and added a link to the Committing section within the "running locally" file to the "contributing" file.

This is expected to make it easier for developers to find the commit guidelines for PRs.

@agilgur5 agilgur5 added the area/docs Incorrect, missing, or mistakes in docs label Aug 29, 2023
Signed-off-by: sunyeongchoi <sn0716@naver.com>
Copy link
Contributor

@agilgur5 agilgur5 left a comment

Choose a reason for hiding this comment

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

Works for me. And I think you have a good point with getting these into the main CONTRIBUTING.md docs. I didn't realize they weren't already there! (one of those things where you learn it once and then don't look too often after)

An alternative may be to add the guidelines in CONTRIBUTING.md, then link to Running Locally for running pre-commit.

Do you want to add the links you added before into the Running Locally page?

docs/CONTRIBUTING.md Outdated Show resolved Hide resolved
sunyeongchoi and others added 2 commits August 30, 2023 16:04
Signed-off-by: sunyeongchoi <sn0716@naver.com>
Signed-off-by: sunyeongchoi <sn0716@naver.com>

Co-authored-by: Anton Gilgur <4970083+agilgur5@users.noreply.github.com>
Signed-off-by: happyso <sn0716@naver.com>
@terrytangyuan terrytangyuan merged commit 7e4ab29 into argoproj:master Aug 30, 2023
22 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area/docs Incorrect, missing, or mistakes in docs
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Relocation of Commit Guidelines Information in the Documentation
3 participants