Skip to content

Comments

docs: add guidelines for writing a meaningful pull request#4197

Merged
veroandreo merged 6 commits intoOSGeo:mainfrom
neteler:docs_add_PR_guidelines
Aug 27, 2024
Merged

docs: add guidelines for writing a meaningful pull request#4197
veroandreo merged 6 commits intoOSGeo:mainfrom
neteler:docs_add_PR_guidelines

Conversation

@neteler
Copy link
Member

@neteler neteler commented Aug 19, 2024

A well-written pull request (PR) is critical because it not only improves collaboration and efficiency within a project but also helps newcomers to contribute more easily.

Fixes #4194

Once accepted a similar PR is needed in the grass-addons repo.

A well-written pull request (PR) is critical because it not only improves collaboration and efficiency within a project but also helps newcomers to contribute more easily.

Fixes #4194
@neteler neteler added the docs label Aug 19, 2024
@neteler neteler added this to the 8.5.0 milestone Aug 19, 2024
@neteler neteler self-assigned this Aug 19, 2024
echoix
echoix previously approved these changes Aug 19, 2024
Copy link
Member

@echoix echoix left a comment

Choose a reason for hiding this comment

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

The general ideas are correct and the text seems fine. Maybe a more thorough linguistic review might be made, but it's enough with this.

@neteler neteler removed their assignment Aug 19, 2024
echoix
echoix previously approved these changes Aug 20, 2024
@veroandreo
Copy link
Contributor

Do we still need this one if the PR template will be in place?

@wenzeslaus
Copy link
Member

It seems all information here can be in the template.

@neteler
Copy link
Member Author

neteler commented Aug 22, 2024

In my optinion we do need a minimum of explanations in github_guide.md.

The new template will be fine but I am frequently trying to onboard new potential contributors.
To simply send them to a template and then wishing "good luck" is not enough in my view. The barrier should be low and some explanations in one place are a good thing and do not harm. I am fine with reducing it here but omitting it entirely isn't very inviting.

@echoix
Copy link
Member

echoix commented Aug 23, 2024

I'll try so reformulate the discussion of this PR.
So we keep the formality of this PR by having it in the docs somewhere. The #4207 is an "implementation" of the (contribution) "requirements" as written in the docs. This means we need both PRs.

As this PR is finished, it can be merged any time now, and we will eventually finish the wording discussions of #4207.

@wenzeslaus
Copy link
Member

Isn't there a middle ground between no documentation and duplicating the template? We could say something like "follow the template".

@neteler
Copy link
Member Author

neteler commented Aug 26, 2024

We could say something like "follow the template".

Text reduced in b2c202f

Co-authored-by: Anna Petrasova <[email protected]>
@veroandreo veroandreo merged commit 42684b3 into OSGeo:main Aug 27, 2024
ShubhamDesai pushed a commit to ShubhamDesai/grass that referenced this pull request Aug 29, 2024
* docs: add guidelines for writing a meaningful pull request

A well-written pull request (PR) is critical because it not only improves collaboration and efficiency within a project but also helps newcomers to contribute more easily.

Fixes OSGeo#4194

* shorten intro text; add link to release.yml

* reduce 'PR Content' description

* add link to PR template

---------

Co-authored-by: Veronica Andreo <[email protected]>
Co-authored-by: Anna Petrasova <[email protected]>
a0x8o pushed a commit to a0x8o/grass that referenced this pull request Sep 5, 2024
* docs: add guidelines for writing a meaningful pull request

A well-written pull request (PR) is critical because it not only improves collaboration and efficiency within a project but also helps newcomers to contribute more easily.

Fixes OSGeo#4194

* shorten intro text; add link to release.yml

* reduce 'PR Content' description

* add link to PR template

---------

Co-authored-by: Veronica Andreo <[email protected]>
Co-authored-by: Anna Petrasova <[email protected]>
Mahesh1998 pushed a commit to Mahesh1998/grass that referenced this pull request Sep 19, 2024
* docs: add guidelines for writing a meaningful pull request

A well-written pull request (PR) is critical because it not only improves collaboration and efficiency within a project but also helps newcomers to contribute more easily.

Fixes OSGeo#4194

* shorten intro text; add link to release.yml

* reduce 'PR Content' description

* add link to PR template

---------

Co-authored-by: Veronica Andreo <[email protected]>
Co-authored-by: Anna Petrasova <[email protected]>
@neteler neteler deleted the docs_add_PR_guidelines branch November 25, 2024 21:12
@neteler neteler modified the milestones: 8.5.0, 8.4.1 Nov 30, 2024
neteler added a commit that referenced this pull request Nov 30, 2024
* docs: add guidelines for writing a meaningful pull request

A well-written pull request (PR) is critical because it not only improves collaboration and efficiency within a project but also helps newcomers to contribute more easily.

Fixes #4194

* shorten intro text; add link to release.yml

* reduce 'PR Content' description

* add link to PR template

---------

Co-authored-by: Veronica Andreo <[email protected]>
Co-authored-by: Anna Petrasova <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Feat] CONTRIBUTING.md and github_guide.md lack PR title and description hints

5 participants