.. _hackathons:

==========
Hackathons
==========

Geomstats core developers organize several hackathons a year, with the following goals:
  * Train new users, e.g. pairing a new user with an experienced Geomstats developer.
  * On-board new contributors, e.g. on collaborative coding practices.
  * Foster new collaborations and strengthen existing ones
  * Bring the community of geometric statistics and learning together.


Interested? Feel free to:
  * Join the next hackathons, either remotely or in person (see section below)
  * Contact Geomstats core developers via Slack to ask about organizing a hackathon at your institution!
  * Organize a hackathon yourself!

Workflow
--------

Coding as a group in an open-source project is different from coding alone.

This is the typical collaborative workflow at a hackathon:

1. **Join** Geomstats slack workspace: Join channel associated with your hackathon 

2. **Assign** yourself to a GitHub task on the GitHub project associated with your hackathon 

3. **Code** a few lines on a new GitHub branch

4. **Document** your code with docstrings

5. **Test** with unit-tests

6. **Lint** to respect the coding style

7. **Submit** a PR on GitHub

8. **Address** code reviews

9. **Merge** your PR

10. **Repeat** :) 

More details can be found in the contributing guidelines.

In a one-day hackathon:
  * we start with a stand-up meeting, where each participant states their goal for the day,
  * participants go through steps 1-10, on a (possibly small) code additions.

In a one-week hackathon:
  * we organize daily stand-up meetings,
  * we expect participants to go 2-3 times through steps 1-10.

Past and future hackathons
--------------------------

2022:

* February 2022: hybrid hackathon:
 * in-person at Inria Sophia-Antipolis, France,
 * remote with participants around the world.

* April 2022: hybrid hackathon:
 * in-person at the Villa Cynthia, CNRS CAES Saint Raphael, France,
 * remote with participants around the world.

* June 2022: in-person hakathon:
 * in-person at the University of Washington (UW), Seattle, US.

* October 2022: hybrid hackathon:
 * in-person during the trimester Geometry and Statistics in Data Sciences, in Paris, France. (October 17-21)
 * remote with participants around the world.
 * `hackathon's webpage <https://indico.math.cnrs.fr/event/8111/>`_.

2021:

* March - April 2021: hybrid hackathon:
 * in-person at Inria Sophia-Antipolis, France,
 * remote with participants around the world.

* July 2021: hybrid hackathon:
 * in-person at the Geometric Science of Information (GSI) conference, Paris, France
 * remote with participants around the world.
 * `hackathon's webpage <https://web2.see.asso.fr/wiki/369069_scai-geomstats-hackathon>`_.

* December 2021: in-person hackathon:
 * in-person at the Sorbonne Center for Artificial Intelligence, Paris, France.
 * `hackathon's webpage <https://scai.sorbonne-universite.fr/public/events/view/578dc8677b284de80cf8/1>`_.
 
2020:

* January 2020: in-person hackathon:
 * in person at Inria Sophia-Antipolis, France

* April 2020: remote hackathon:
 * remote via Zoom and Slack with participants around the world.

Related events
--------------

In addition to hackathons, we co-organize international coding challenges.

* April 2021: international Coding Challenge at the International Conference on Learning Representations (ICLR)
* April 2022: international Coding Challenge at the International Conference on Learning Representations (ICLR)




.. toctree::
   :maxdepth: 1
   :hidden:

   hackathons/ihp_10_2022