introduction.tex

\documentclass[slidestop]{beamer}

\usepackage{tikz}

\definecolor{break}{rgb}{0,0.5,0}
\definecolor{lecture}{rgb}{0.11,0.27,0.7}
\definecolor{practical}{rgb}{0.94,0.23,0.18}

\input{../shared/shared.tex}

\author{}
\title{\courseTitle}
\providecommand{\mySubTitle}{Introduction to Version Control}
\providecommand{\myConference}{\courseTitle}
\providecommand{\myGroup}{}
\providecommand{\myDepartment}{}
\providecommand{\myCenter}{}

\usetheme{lumc}

\begin{document}

% This disables the \pause command, handy in the editing phase.
%\renewcommand{\pause}{}

% Make the title page.
\makeTitleSlide{\includegraphics[width=3.5cm]{images/git_logo.pdf}}

% First page of the presentation.
\section{Course Outline}
\begin{pframe}
 \vspace{-0.8cm}
 \begin{itemize}
  \item \textcolor{lecture}{Introduction}
  \item \textcolor{lecture}{Git basics}
  \item \textcolor{practical}{Practical 1}
  \item \textcolor{lecture}{The git commit graph}
  \item \textcolor{practical}{Practical 2}
  \item \textcolor{break}{Lunch break}
  \item \textcolor{lecture}{Colaboration: remote repositories}
  \item \textcolor{practical}{Practical 3}
 \end{itemize}
 \bigskip
 \url{https://git.lumc.nl/courses/gitcourse}
\end{pframe}

\section{Introduction Outline}
\begin{pframe}
 \begin{itemize}
  \item What is version control?
  \begin{itemize}
   \item Definition
   \item General features
   \item Step by step example
   \item Distributed repositories
   \item Why to use/not use version control?
  \end{itemize}
  \item Git
  \item Web-based remotes
  \begin{itemize}
   \item GitLab vs GitHub
  \end{itemize}

 \end{itemize}
\end{pframe}

\section{What is version control?}
\subsection{Definition}
\begin{pframe}
  \emph{The \textbf{management of changes} to documents, computer programs, large web
        sites, and other collections of information.}\\
  --- \textcolor{darkgray}{\href{https://en.wikipedia.org/wiki/Version_control}{Wikipedia}}
  \\ \\
  \emph{A system that \textbf{records changes} to a file or set of files
        over time so that you can recall specific versions later.}\\
  --- \textcolor{darkgray}{\href{https://git-scm.com/book/en/v2/Getting-Started-About-Version-Control}{https://git-scm.com/}}

  \begin{tikzpicture}[remember picture,overlay]
    \node[xshift=-3.3cm,yshift=-7.2cm] at (current page.north east) {\includegraphics[width=4cm]{images/version_control-slide.pdf}};
  \end{tikzpicture}
\end{pframe}

\subsection{General features}
\begin{pframe}
  \begin{itemize}
    \item Keep track of your files in an orderly manner.
    \begin{itemize}
      \item Hide old versions.
      \item Easily access old versions.
      \item Check the differences between current and older versions.
    \end{itemize}
  \end{itemize}
  \begin{itemize}
    \item Enables collaboration.
    \begin{itemize}
     \item Record who made changes and when.
    \end{itemize}
  \end{itemize}
\end{pframe}

\subsection{Step by step}
\begin{pframe}
 \begin{center}
  \includegraphics[width=1\textwidth]{images/vcs_example/vcs_example_00.pdf}
 \end{center}
\end{pframe}

\begin{pframe}
 \begin{center}
  \includegraphics[width=1\textwidth]{images/vcs_example/vcs_example_01.pdf}
 \end{center}
\end{pframe}

\begin{pframe}
 \begin{center}
  \includegraphics[width=1\textwidth]{images/vcs_example/vcs_example_02.pdf}
 \end{center}
\end{pframe}

\begin{pframe}
 \begin{center}
  \includegraphics[width=1\textwidth]{images/vcs_example/vcs_example_03.pdf}
 \end{center}
\end{pframe}

\begin{pframe}
 \begin{center}
  \includegraphics[width=1\textwidth]{images/vcs_example/vcs_example_04.pdf}
 \end{center}
\end{pframe}

\begin{pframe}
 \begin{center}
  \includegraphics[width=1\textwidth]{images/vcs_example/vcs_example_05.pdf}
 \end{center}
\end{pframe}

\begin{pframe}
 \begin{center}
  \includegraphics[width=1\textwidth]{images/vcs_example/vcs_example_06.pdf}
 \end{center}
\end{pframe}

\begin{pframe}
 \begin{center}
  \includegraphics[width=1\textwidth]{images/vcs_example/vcs_example_07.pdf}
 \end{center}
\end{pframe}

\begin{pframe}
 \begin{center}
  \includegraphics[width=1\textwidth]{images/vcs_example/vcs_example_08.pdf}
 \end{center}
\end{pframe}

\begin{pframe}
 \begin{center}
  \includegraphics[width=1\textwidth]{images/vcs_example/vcs_example_09.pdf}
 \end{center}
\end{pframe}

\begin{pframe}
 \begin{center}
  \includegraphics[width=1\textwidth]{images/vcs_example/vcs_example_10.pdf}
 \end{center}
\end{pframe}

\subsection{Local repository}
\begin{pframe}
 \begin{center}
   \includegraphics[width=\textwidth]{images/vcs_layout_local.pdf}
 \end{center}
\end{pframe}

% \subsection{Central repository}
% \begin{pframe}
%  \begin{center}
%    \includegraphics[width=\textwidth]{images/vcs_layout_central.pdf}
%  \end{center}
% \end{pframe}

\subsection{Distributed repositories}
\begin{pframe}
 \begin{center}
   \includegraphics[width=\textwidth]{images/vcs_layout_distributed.pdf}
 \end{center}
\end{pframe}

\begin{pframe}
 \begin{center}
   \includegraphics[width=\textwidth]{images/vcs_layout_distributed_remotes.pdf}
 \end{center}
\end{pframe}

\subsection{Why should I use it?}
\begin{pframe}
  For a single user:
  \begin{itemize}
   \item Revert files to a previous state.
   \item Revert the entire project back to a previous state.
   \item Review changes made over time.
   \item Backup.
  \end{itemize}
  \pause
  For multiple users:
    \begin{itemize}
     \item A reliable way to share files between people/computers.
     \item Allow multiple people working on the same project at the same time.
     \item Conflict resolution.
     \item See who made which changes at which time.
    \end{itemize}
\end{pframe}

\subsection{Why should I not use it?}
\begin{pframe}
  \bigskip

  \begin{itemize}
    \item I have my own system.
  \end{itemize}
  \pause
  \begin{tikzpicture}[remember picture,overlay]
    \node[xshift=-3.4cm,yshift=-5.4cm] at (current page.north east) {\includegraphics[width=6cm]{images/project_tree.pdf}};
  \end{tikzpicture}
\end{pframe}

\begin{pframe}
  A list of common excuses:
  \begin{itemize}
    \item I have my own system.
    \item It is too much work.
    \item I am the only one working \\ on this project.
    \item This code will not be \\ used by anyone else.
    \item The bugs can be \\ tracked forever.
    \item \ldots
  \end{itemize}

  \begin{tikzpicture}[remember picture,overlay]
    \node[xshift=-3.4cm,yshift=-5.4cm] at (current page.north east) {\includegraphics[width=6cm]{images/project_tree.pdf}};
  \end{tikzpicture}
\end{pframe}

\begin{pframe}
  A list of common excuses:
  \begin{itemize}
    \item I have my own system.
    \item It is too much work.
    \item I am the only one working \\ on this project.
    \item This code will not be \\ used by anyone else.
    \item The bugs can be \\ tracked forever.
    \item \ldots
  \end{itemize}

  Eventually leading to:
  \begin{itemize}
    \item I'm too busy rewriting the code I accidentally deleted.
  \end{itemize}
  \begin{tikzpicture}[remember picture,overlay]
    \node[xshift=-3.8cm,yshift=-5.6cm] at (current page.north east) {\includegraphics[width=7cm]{images/desperate.pdf}};
  \end{tikzpicture}
\end{pframe}

\section{Git}
\subsection{The name}
\begin{pframe}
  \emph{Git (n): A person who is deemed to be despicable or contemptible.} ---
  WordNet.
  \bigskip

  \emph{I'm an egotistical bastard, and I name all my projects after myself.
  First ``Linux'', now ``git''.} --- Linus Torvalds.

  \begin{center}
   \includegraphics[width=0.6\textwidth]{images/penguin.pdf}
 \end{center}
\end{pframe}

\subsection{History}
\begin{pframe}
  Designed to replace the commercial package \emph{BitKeeper}.
  \begin{itemize}
    \item Speed.
    \item Simple design.
    \item Strong support for non-linear development
    \begin{itemize}
     \item Thousands of parallel branches.
    \end{itemize}
    \item Fully distributed.
    \item Able to handle large projects like the Linux kernel efficiently.
  \end{itemize}
  % The copyright holder of BitKeeper, Larry McVoy, had withdrawn gratis use of
  % the product after claiming that Andrew Tridgell had reverse-engineered the
  % BitKeeper protocols.

  % .. version 4.1, released in June 2015, has grown to over 19.5 million lines
  % of code contributed by almost 14,000 programmers.
\end{pframe}

\subsection{Installation}
\begin{pframe}
 \begin{itemize}
  \item Linux
  \begin{itemize}
   \item \lstinline{sudo apt-get install git} (Ubuntu)
   \item \lstinline{sudo yum install git} (Fedora)
  \end{itemize}
  \item Windows
  \begin{itemize}
   \item git-scm.com/download/win
  \end{itemize}
  \item Mac
  \begin{itemize}
   \item git-scm.com/mac
  \end{itemize}
 \end{itemize}

 Once installed you can check Git version:
 \begin{itemize}
  \item \lstinline{git --version}
 \end{itemize}

\end{pframe}


\section{Remotes}
\subsection{Web-based}
\begin{pframe}
 \begin{center}
   \includegraphics[width=\textwidth]{images/central_remotes.pdf}
 \end{center}
\end{pframe}

\begin{pframe}
 \begin{center}
   \includegraphics[width=\textwidth]{images/central_remotes_01.pdf}
 \end{center}
\end{pframe}

\begin{pframe}
  GitHub:
  \begin{itemize}
    \item Free for public repositories. Paid for private ones.
    \item Hosting provided for free.
  \end{itemize}
  \bigskip

  GitLab:
  \begin{itemize}
    \item Self hosting - own installation.
    \item No hosting provided.
    \item Basic features for free. Paid advanced ones.
  \end{itemize}
\end{pframe}

\makeAcknowledgementsSlide{
  \begin{tabular}{l}
    \acknowledgements
  \end{tabular}
  \bigskip

  \hfill\includegraphics[width=3.5cm]{git_logo}

  \begin{tabular}{l}
    \small\url{https://git.lumc.nl/humgen/gitcourse}
  \end{tabular}
}

\end{document}