Skip to content

Conversation

@thomaskileyukaea
Copy link
Contributor

Previously the course said that on a shared repository everyone can push to the main branch, but people should be encouraged to raise pull requests.

GitHub you can enforce this action by protecting the main branch.

I think the course should be instruction the attendees to do this. Without branch protection, it is very easy to accidentally push to the main branch, which can disrupt other developers, miss out on the advantages CI and code review give you, and create confusion about whether that is ever the right approach.

This change alters the text to instruct attendees how to configure branch protection with sensible defaults, and suggests that they do that.

As the text is no longer suitable for a bullet point (and it was pretty long before!) I also put the content under a header. It might be easiest to review the changes commit by commit.

To make the unformatted markdown easier to read, introduce some line
breaks
Since there is quite a lot of text, put under actual headings rather than as part
of the bullet point list
These instructions mean that on a shared repository the pull request
system must be used. This prevents accidentally pushing to the main
branch, as well as ensuring people get into the habbit of raising
pull requests for their changes.
@thomaskileyukaea
Copy link
Contributor Author

Replaced by #213

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.

1 participant