Warning:
This wiki has been archived and is now read-only.
How to work with GitHub
From Spatial Data on the Web Working Group
Recommended pattern for github workflow for W3C spec drafting:
- create a local copy of the W3C SDW repo: git clone https://github.com/w3c/sdw.git
- configure remotes on local - specify the W3C repo remote as `upstream`: git remote add upstream --track https://github.com/w3c/sdw.git
- because we're using GitHub Pages for publication, `gh-pages` is our main branch
- create a branch in your local repo which tracks gh-pages in upstream: git checkout -b {my-branch-name} upstream/gh-pages
- make the changes in your branch & commit - with commit message please!
- synchronise your changes with upstream: git push upstream {my-branch-name}
- note LvdB: git push upstream {my-branch-name}:{my-branch-name} to make sure to push to own working branch remotely instead of directly to gh-pages
- within GitHub, create a Pull Request from {my-branch-name} into gh-pages ... at this point, you might assign the PR to someone else to check before merging
- EDITORS ONLY: within GitHub, Merge the changes into gh-pages ... then you will see your stuff @ http://w3c.github.io/sdw/bp/
- bring all those changes back into your local repo: git fetch upstream
- rebase (don't 'pull' - because this creates another commit) changes on your branch: git rebase upstream/gh-pages
(you might also want to rebase local/gh-pages too)
Alternatively - send your text to the Editors (Linda, Payam, Jeremy) via the WG email list.