https://github.com/swcarpentry/workshop
The “master” branch has the current state-of-the-art source for the
-instructors' projected content (HTML pages, PDF slides, …), handouts,
-workshop homepage, …. If we can't agree on a canonical
-representation, there may be a handful of feature branches with
-alternative content.
+instructors' projected content, handouts, workshop homepage, …. If we
+can't agree on a canonical representation, there may be a handful of
+feature branches with alternative content.
Topics will live in per-subject subdirectories, ideally organized in
half-day-sized chunks.
.
├── README.md
├── debugging
- │ ├── README.ipynb
+ │ ├── README.md
│ …
├── make
│ ├── README.md
│ ├── example-project
│ …
├── python
- │ ├── README.rst
+ │ ├── README.md
│ ├── animals.txt
│ …
├── shell
This gives a starting point for developing your workshop.
- -o--o--o--o--o master
- \-o--o \ git-wtk
+ -o--o--o--o--o origin/master (same as local master)
+ \-o--o \ origin/git-wtk
\------o 2012-12-my-workshop
Figure 2: Graph of commits for the beginning of the
(location, dates, master-index, …). These changes should go into the
workshop branch:
- -o--o--o--o--o master
- \-o--o \ git-wtk
+ -o--o--o--o--o origin/master
+ \-o--o \ origin/git-wtk
\------o--a--b 2012-12-my-workshop
Figure 2: Workshop-specific changes go into the workshop-specific
a README.md: link to shell, git/basic, and git/advanced
b README.md: localize for 2012-12 workshop at my house
-If you want to change some of the general content, you have some
-choices.
+If you want to change some of the general content, you should make
+your change on the master branch (or the feature branch like
+“git-wtk”). Then pull your changes into your workshop branch and make
+a pull request for inclusion in the master repository.
-1. With commit rights to the central repo, go ahead and make your
- change on the master branch (or the feature branch like “git-wtk”).
- Then pull your changes into your workshop branch.
+ /-a----\---\ typo-fix
+ -o--o--o--o--o--------\---c origin/master
+ \-o--o \ \ origin/git-wtk
+ \------o--o--o--b 2012-12-my-workshop
- -o--o--o--o--o--a-----\ master
- \-o--o \ \ git-wtk
- \------o--o--o--b 2012-12-my-workshop
+ Figure 3: You can't push to master, so you made a new “typo-fix”
+ branch. Later on, a SWC dev will merge it into master. Example
+ log:
- Figure 3: General changes go into their general branch. Example log:
+ commit message
+ ------ --------------------------------------------------
+ a git/basic: fix origin\master -> origin/master typo
+ b merge recent master branch updates
+ c git/basic: merge origin\master typo fix
- commit message
- ------ --------------------------------------------------
- a git/basic: fix origin\master -> origin/master typo
- b merge recent master branch updates
-
-2. If you can't commit to the central repo, put your changes in their
- own feature branch and make a pull request.
-
- /-a----\---\ typo-fix
- -o--o--o--o--o--------\---c master
- \-o--o \ \ git-wtk
- \------o--o--o--b 2012-12-my-workshop
-
- Figure 4: You can't push to master, so you made a new “typo-fix”
- branch. Later on, a SWC dev will merge it into master (c). The
- content of commits “a” and “b” is the same as in Figure 3.
-
-3. You don't like this fancy branch stuff, so you just make the commit
- in your workshop branch. You let the SWC devs know so they can
- cherry-pick it into the master branch.
-
- -o--o--o--o--o------------d master
- \-o--o \ : git-wtk
- \------o--o--o--a 2012-12-my-workshop
-
- Figure 5: You make the general change “a” in your workshop branch.
- SWC devs have to cherry pick the change into the master with “d”.
- This makes it awkward for other people to base work off your
- workshop branch. It is even more awkward if you've stuffed
- workshop-specific changes into “a”, but you can avoid that by
- making clean commits.
-
-4. If you really want to roll your own content, feel free to skip the
- master branch entirely.
-
- -o--o--o--o--o master
- \-o--o git-wtk
- I--o--o--a 2012-12-my-workshop
-
- Figure 6: A disjoint branch (2012-12-my-workshop). The commit “I”
- has no parents. Different branches stored in the same repository
- don't need to share any common commits. They're still addressing
- the same goal, and having them in the same repo means its easier
- to clone/fetch/diff/….
+If you really want to roll your own content, feel free to skip the
+master branch entirely.
+
+ -o--o--o--o--o origin/master
+ \-o--o origin/git-wtk
+ I--o--o--a 2012-12-my-workshop
+
+ Figure 4: A disjoint branch (2012-12-my-workshop). The commit “I”
+ has no parents. Different branches stored in the same repository
+ don't need to share any common commits. They're still addressing
+ the same goal, and having them in the same repo means its easier to
+ clone/fetch/diff/….
Publishing workshop websites
============================
tag.
If your workshop branch has been living in your own personal
-repository. Submit a pull request to the master repo, and a SWC dev
-will import your branch, tag the tip, and delete the branch for you.
+repositor, submit a pull request to the master repo. A SWC dev will
+import your branch, tag the tip, and delete the branch for you.
[1]: There's a mock-up at https://github.com/wking/swc-workshop
projects / workshop-organization.git / blobdiff