Workshop
########

What
====

A **practical** interactive workshop on learning how to use version
control, and an introduction to using the shell (aka terminal aka
commandline).

The version control software is fossil_, and the shell is Zsh_
(through Cygwin).

.. _fossil: https://fossil-scm.org/
.. _Zsh: https://en.wikipedia.org/wiki/Z_shell

Why
===

The workshop aims to help you with organizing your code and
documents. Have you experienced times when your code used to work
yesterday but doesn't today because of a few minor changes you made
and forgot? Or times when you change your code and want to change back
later, but forget what were all the changes and which one you want to
change back? Version control is your solution! Come to our workshop
for a kick start of efficient winter research!

When and where
==============

- **Wednesday Feb 12th at 13:15–15:45 in the ARC 233** of the
  `Advanced Research Complex`_

   - Please :ref:`install <software-prereq>` the software on your
     computer in advance!

      - 13:15–14:00 software setup/troubleshooting + food (optional if
        you've done it in advance and you don't want free food)

      - 14:00–14:30 intro to shell (required for next part!)

      - 14:30–15:00 version control tutorial (part 1/2)

      - 15:00–15:10 break

      - 15:10–15:45 version control tutorial (part 2/2)

.. _`Advanced Research Complex`: https://www.openstreetmap.org/way/307247853#map=19/45.42139/-75.67922

What do I need
==============

This is a practical workshop, so please bring a personal computer. If
you have time, I strongly recommend that you go through the
:ref:`software setup guide <software-prereq>` before the workshop
itself. `Contact me`_ if you have issues!

.. _`Contact me`: https://www.ecd.space/

What if you get hit by a bus and this great resource goes offline?
==================================================================

This entire guide (including the "setup.sh" script!) is in a Fossil
repository hosted at https://hydra.ecd.space/eduard/vc-workshop-201805/\ ,
of which you can grab a full copy for safekeeping using the following
command::

  fossil clone https://hydra.ecd.space/eduard/vc-workshop-201805/ vc_workshop_201805.fossil

You can also just grab a ZIP archive of the latest commit from
https://hydra.ecd.space/eduard/vc-workshop-201805/zip/vc-workshop-201805.zip?r=trunk\ .

Acknowledgements
================

2019-02\@uOttawa
----------------

This session was organized by the uOttawa Physics Grad Students
Association (PGSA). Many thanks in particular to Alan Godfrey, Erin
Flannigan, Benoit Vanus, Spencer Sterling, Kate Fenwick, Saad bin
Alam, and Daisy Xia.

2019-01\@McGill
---------------

Many thanks to Thomas Rademaker for organizing this workshop!

2018-05\@uOttawa
----------------

This workshop series was organized by the uOttawa Physics Grad
Students Association (PGSA). Many thanks in particular to Ludmila
Szulakowska (PGSA president), in particular for the "why" text above,
and to Daisy Xia (PGSA communications officer).

Why fossil? Isn't git more popular?
===================================

Quick_ answer and detailed_ answer.

.. _Quick: https://www.fossil-scm.org/index.html/doc/trunk/www/quotes.wiki
.. _detailed: https://www.fossil-scm.org/index.html/doc/trunk/www/fossil-v-git.wiki

Contact
=======

Eduard Dumitrescu's contact info is here_.

.. _here: https://www.ecd.space/