From e8fa90b37b199959c9348b9bb94907627c08d769 Mon Sep 17 00:00:00 2001
From: Martijn Vermaat <martijn@vermaat.name>
Date: Fri, 20 Jun 2014 17:23:26 +0200
Subject: [PATCH] Some notes on using our GitLab server

---
 remotes/remotes_handouts.tex | 26 +++++++++++++++++++++++---
 1 file changed, 23 insertions(+), 3 deletions(-)

diff --git a/remotes/remotes_handouts.tex b/remotes/remotes_handouts.tex
index a058082..fa3ff52 100644
--- a/remotes/remotes_handouts.tex
+++ b/remotes/remotes_handouts.tex
@@ -13,12 +13,30 @@ Git and remote repositories practical.
 \end{center}
 \bigskip
 
+\subsubsection*{Some notes about using GitLab.}
+Please take the following into account with respect to our GitLab server:
+\begin{itemize}
+  \item You can login to GitLab using your LUMC account.
+  \item If you don't have an LUMC account, ask us to create a GitLab account
+    for you and select {\em Standard} instead of {\em LDAP} on the login
+    page.
+  \item Due to the LUMC firewall, accessing repositories using SSH is only
+    possible from the LUMC network (and not from the LUMC gast network). As an
+    alternative, you can always use HTTPS but the downside is that you have to
+    keep repeating your password.
+  \item Our GitLab server is very similar (in fact, it is a clone) to the
+    popular online GitHub (\texttt{https://github.com}) and Bitbucket
+    (\texttt{https://bitbucket.org}) services.
+\end{itemize}
+
+\bigskip
+
 \subsubsection*{Add your repository to GitLab.}
 Now you have a nice repository, of course you want to share it on GitLab.
 
 \bigskip
 
-Go to GitLab and create a new project.
+Go to GitLab (\texttt{https://git.lumc.nl}) and create a new project.
 
 \begin{itemize}
   \item \emph{Question:} What is the repository URL for your new project?
@@ -26,7 +44,7 @@ Go to GitLab and create a new project.
 
 \bigskip
 
-Add a remote for your GitLab repository.
+Add the GitLab repository as a remote to your local repository.
 
 \bigskip
 
@@ -37,6 +55,7 @@ Push your branch(es) to GitLab.
     interface?
 \end{itemize}
 
+\bigskip
 
 \subsubsection*{Clone an existing repository from GitLab.}
 There already are some nice repositories on GitLab! Pick one (e.g., from the
@@ -52,8 +71,9 @@ Create a local clone of the repository you picked.
     branches exist?
 \end{itemize}
 
+\bigskip
 
-\subsubsection*{For experts: create a merge request.}
+\subsubsection*{Create a merge request.}
 If you are interested, here are some additional GitLab features you can
 use. Fork an existing project, implement a feature, and submit a merge
 request.
-- 
GitLab