You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/guides/Git_workflow_exercises.md
+33-25
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
### GitHub workflows
2
2
3
-
To get setup as a PhUSE CS contributor, see [Contributor_setup.md](https://github.com/phuse-org/phuse-scripts/blob/master/docs/guides/Contributor_Setup.md)
3
+
To get setup as a PhUSE CS collaborator, see [Contributor_setup.md](https://github.com/phuse-org/phuse-scripts/blob/master/docs/guides/Contributor_Setup.md)
[GitHub article on Repository Permission Levels](http://help.github.com/articles/repository-permission-levels-for-an-organization/)
12
12
13
-
1.phuse-or/phuse-scripts Maintainers: can change master code
14
-
2.GitHub Contributors: can create "pull request" from their own branch, for the Maintainers to review
13
+
1.Write-Access Collaborators (int): can create/modify "master" files
14
+
2.Read-Access Collaborators (ext): can send "pull requests" from their own "forks", for the Write-Access team to assess
15
15
16
-
Relevant roles for phuse-org/phuse-scripts?
17
-
1. Admin (manage repository settings, NOT relevant for workshop)
18
-
2. Maintainer (write access)
19
-
3. Contributors (no write access)? [our repo teams](https://github.com/phuse-org/phuse-scripts/settings/collaboration)
16
+
#### Setup for the phuse-org/phuse-scripts repository
20
17
21
-
#### phuse-or/phuse-scripts Setup
22
-
23
-
* Master branch is always "production ready"
24
-
* Therefore relatively few "Maintainers", who
25
-
* have "write access", and can therefore
26
-
* review "pull requests" and commit changes to master branch
18
+
* Master branch is always "ready to deploy"
19
+
* Therefore relatively few "Write-Access" members, who can
20
+
* create/modify files directly, and
21
+
* review "pull requests", merge them into the "master"
27
22
* Any GitHub member can
28
23
* "fork" the phuse-scripts repository
29
-
*develop new scripts or enhance any element
30
-
*create a "pull request", a proposal to incorporate your modifications into the phuse-scripts repository
24
+
*create/modify files in their "fork"
25
+
*send a "pull request" back to the origin repo (phuse-scripts)
31
26
32
-
#### GitHub Exercises PSch: Are we creating some 'sandbox for this? What files to we use for examples?
27
+
#### GitHub Exercises
33
28
34
-
* Simple steps: Contributor suggests a change to an UNmodified file on the master branch
35
-
1.Contributor:
29
+
* Simple scenario: Collaborator suggests a change to an UNmodified file on "master"
30
+
1.EXT. Collaborator:
36
31
* ... forks the phuse-scripts repository
37
32
* ... [or re-SYNC existing, out-of-sync fork]
38
33
* ... creates/modifies file in your new fork
39
34
* ... creates "pull request" in the fork
40
35
* this redirects you to the source repo (note path in page header)
41
36
* request pull _from_ your fork, _to_ the original repo
42
-
*... demo & track locations
43
-
2.Maintainers:
44
-
* ... receives GitHub notification of "pull request" [CLARIFY!]
45
-
* ... reviews the pull request, changes
46
-
* ... [DISCUSS WITH CONTRIBUTOR!]
47
-
* ... approve / reject
48
-
3.Contributor:
37
+
*(demo of discussing and resolving a pull request)
38
+
2.INT. Collaborator:
39
+
* ... receives GitHub notification of "pull request" _(depends on user settings)_
40
+
* ... reviews the pull request
41
+
* ... discusses with ext. collaborator
42
+
* ... approves / rejects
43
+
3.EXT. Collaborator:
49
44
* Option to delete fork
50
45
*[RESYNC with latest changes from original repo]
51
46
@@ -56,7 +51,20 @@ Relevant roles for phuse-org/phuse-scripts?
56
51
4. resolve any conflicts
57
52
5. "pull request" ... screenshots
58
53
6. Now as above?
54
+
55
+
1. EXT. Collaborator:
56
+
* ... Re-syncs with origin repo, so always working with up-to-date files. [Re-syncing requires command line](https://help.github.com/articles/syncing-a-fork/)
57
+
* ... develops a new feature, extensive changes in own fork
58
+
* ... creates "pull request" in the fork
59
+
2. INT. Collaborator:
60
+
* ... receives GitHub notification of "pull request" _(depends on user settings)_
61
+
* ... reviews the pull request
62
+
* ... discusses with contributor
63
+
* (will advise EXT. to re-sync & try again, if it's clear s/he has not first pulled latest changes!)
0 commit comments