thiago37 / sandbox

A space to test Git/github features, feel free to "fork" files and play around...

Sandbox

This is a space for the openEHR community to test Git/github features, feel free to "fork" files and play around...

Currently Thomas Beale and Erik Sundvall are administrators of this "Sandbox" repository, but the thing with Git/Github is that YOU can dig in and modify ("fork") files in your own space right away (if you have a free Github account).

Your private fork will be "connected" to the original files (visible in the network graph at https://github.com/openEHR/Sandbox/network) and all or some of your changes can (fairly easily) be "pulled" into later versions of the original file repository or into somebody else's fork(s).

Forking and simple file editing can be done online via the the Github web interface if you don't need local/offline editing.

There are now very nice simple clients available for Github

• Windows: http://windows.github.com/
• Mac: http://mac.github.com/
• Linux users will be competent enough to find what they need...

Mor help can be found via e.g. https://help.github.com/

The GIT clients create a local copy/fork of repositories (like this "Sandbox") on your computer, you can then update add or remove files locally. Whenever you want to freeze a snapshot of your work, you commit locally and it becomes a local "unsynced commit". Whenever you want to share your progress with others (or your other computers) you sync your changes over to your own github account (this can also be done using the client).

These above described local commits do not affect other peoples work, so feel free to secure your work by committing and even syncing to Github often. Sync is bidirectional, but don't fear, your own fork will not contain any scary incoming changes unless you have put them there yourself ;-)

If you want to suggest that your modifications (made available in your public github fork) should be taken into the main/original openEHR project, then you issue a "pull request" and the rest is up to the repository admins (Tom & Erik currently). Even when the admins are slow to respond and merge your work to some "official" fork, your improvments can anyway easily be pulled in by others to their own forks (circumventing possible bottlenecks).

Please test, and have fun!