:clipboard: Guidelines & Workflow for people contributing to our project(s) on GitHub. Please :star: to confirm you've read & understood! :white_check_mark:
What does a branch (and corresponding pull request) named "test" add to (fix or remove from) the project?
People keep forgetting that the purpose of writing code
and (then) getting it merged it into a project
is to communicate as much as possible with teammates.
"Programs must be written for people to read, and only incidentally for machines to execute." ~ Harold Abelson
"Any fool can write code that a computer can understand. Good programmers write code that humans can understand." ~ Martin Fowler
@nvie has a detailed post on this: http://nvie.com/posts/a-successful-git-branching-modelhowever I would not describe it as "beginner friendly" ... we should encourage people to read it as "further" or "background" reading, but we should distill it to a simple rule that anyone can follow without "advanced" git knowledge.
Proposal for Git Branch Naming
Git branches should be named descriptively.
Avoid one word names like test or fix.
Include the issue number in the branch name
A good (descriptive/helpful) branch name and PR name/description:
Note: I am guilty of using branch names that are not "team friendly" so trying not to "throw stones".
We have notes creating Good Pull Requests: github.com/dwyl/contributing#notes-on-creating-good-pull-requests However we are still getting PRs that are named in an unhelpful way ... 😞![poor-branch-and-pr-name](https://user-images.githubusercontent.com/194400/28962651-4126f9de-78fe-11e7-96f1-dadb47c026d8.png)
What does a branch (and corresponding pull request) named "test" add to (fix or remove from) the project?
People keep forgetting that the purpose of writing code and (then) getting it merged it into a project is to communicate as much as possible with teammates.
Some teams/organisations have a branch naming convention e.g: https://github.com/agis/git-style-guide#branches
@nvie has a detailed post on this: http://nvie.com/posts/a-successful-git-branching-model however I would not describe it as "beginner friendly" ... we should encourage people to read it as "further" or "background" reading, but we should distill it to a simple rule that anyone can follow without "advanced" git knowledge.
Proposal for Git Branch Naming
test
orfix
.A good (descriptive/helpful) branch name and PR name/description:![image](https://user-images.githubusercontent.com/194400/28964326-386d7cfe-7904-11e7-8e4a-fa20e3dda1e0.png)