Skip to content

Conversation

jputrino
Copy link
Contributor

@jputrino jputrino commented Jan 7, 2025

This commit adds a section on the repo's branch protection rules to the CONTRIBUTING doc.

Proposed changes

Write a clear and concise description that helps reviewers understand the purpose and impact of your changes. Use the
following format:

Problem: Give a brief overview of the problem or feature being addressed.

Solution: Explain the approach you took to implement the solution, highlighting any significant design decisions or
considerations.

Testing: Describe any testing that you did.

Please focus on (optional): If you any specific areas where you would like reviewers to focus their attention or provide
specific feedback, add them here.

If this PR addresses an issue on GitHub, ensure that you link to it here:

Closes #ISSUE

Checklist

Before creating a PR, run through this checklist and mark each as complete.

  • I have read the contributing guidelines

  • I have signed the F5 Contributor License Agreement (CLA)

  • If applicable, I have added tests that prove my fix is effective or that my feature works

  • If applicable, I have checked that any relevant tests pass after adding my changes

  • I have updated any relevant documentation (README.md and CHANGELOG.md)

  • I have rebased my branch onto main

  • I will ensure my PR is targeting the main branch and pulling from my branch from my own fork

  • If the change involves:

    • Code
    • Anything that resembles Personally identifying information (PII)
      • Make sure to use placeholders such as <username> in place of PII
    • URLs (watch for typosquatting)
    • Significant new/revised content

    In these cases, the change will require at least two (2) approvals before merging

This commit adds a section on the repo's branch protection rules to the CONTRIBUTING doc.
@jputrino jputrino added the documentation Improvements or additions to documentation label Jan 7, 2025
@jputrino jputrino self-assigned this Jan 7, 2025
@jputrino jputrino requested a review from a team as a code owner January 7, 2025 22:25
Copy link

github-actions bot commented Jan 7, 2025

✅ All required contributors have signed the F5 CLA for this PR. Thank you!
Posted by the CLA Assistant Lite bot.

@jputrino
Copy link
Contributor Author

jputrino commented Jan 7, 2025

I have hereby read the F5 CLA and agree to its terms

Copy link

github-actions bot commented Jan 7, 2025

Deploy Preview will be available once build job completes!

Name Link
😎 Deploy Preview https://frontdoor-test-docs.nginx.com/previews/docs/50/

Copy link
Contributor

@ADubhlaoich ADubhlaoich left a comment

Choose a reason for hiding this comment

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

Branch protection rule section looks good to me, though I'm not sure why you've shifted the discussion and git titles from sentence case to title case.

@jputrino jputrino linked an issue Jan 7, 2025 that may be closed by this pull request
1 task
@jputrino
Copy link
Contributor Author

jputrino commented Jan 7, 2025

Branch protection rule section looks good to me, though I'm not sure why you've shifted the discussion and git titles from sentence case to title case.

I debated the discussion change. I decided it should be capitalized because it's a proper noun in GitHub parlance. Happy to change back if that's preferred!

This repository has the following branch protection rules in place:

- **Pushing branches that contain the "internal/" prefix is not allowed.** This ensures internal development branches are not accidentally or purposefully pushed to this repo.
- **Two approvers are required for all merges to main and release branches.** This ensures all code that is approved for release to production is appropriately reviewed. This rule applies to all branches with `*release*` in the branch name.
Copy link
Contributor

Choose a reason for hiding this comment

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

Info: we should also update https://github.com/nginx/documentation/blob/main/.github/pull_request_template.md#checklist accordingly. I know @ADubhlaoich is currently working on this file.

@jputrino jputrino merged commit 78dac56 into main Jan 7, 2025
4 of 5 checks passed
@jputrino jputrino deleted the jputrino-update-contributing branch January 7, 2025 22:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Fix code scanning alert - Code-Review
3 participants