The ChessAIThon project (2025-1-ES01-KA220-VET-000354329) is co-funded by the European Union. The views and opinions expressed in this publication are those of the author(s) only and do not necessarily reflect those of the European Union or the Spanish Service for the Internationalisation of Education (SEPIE). Neither the European Union nor the National Agency SEPIE can be held responsible for them.

Chess data: formats structures and dataset files, control version

Home

Table of Contents

Part 1

Teaching version control with Git and GitHub is essential for collaborative coding and data science.

Explain to students that Git is the tool on their computer for tracking changes, and GitHub is the cloud platform—a place to share, backup, and collaborate on free software projects like our project.

Core Concepts and Workflow

The core concept is the repository (repo), which holds all the project files and its complete history. Students contribute by following a simple workflow:

  • Clone/Pull: They use git clone or pull to copy the repository's latest version from GitHub to their local machine.
  • Commit/Push: After making changes to their code or adding their chess datasets (CSV or Parquet files), they commit those changes to their local Git history. Then, they push their commits to the public GitHub repository, sharing their work.

For advanced collaboration, introduce branch creation and merging:

  • Students should create a branch for new features or data additions, keeping their work separate from the main project code.
  • Once their work is complete and tested, they merge their branch back into the main line.

This teaches them how professionals manage parallel workstreams and resolve conflicts.