Changes

Jump to navigation Jump to search
Added draft of FAQ
Line 69: Line 69:  
Once logged in, there are no further differences.
 
Once logged in, there are no further differences.
   −
== Setup, Configuration and Usage of Git ==
+
== Setup, Configuration and Usage of Git clients ==
For more advanced tasks, you will need a Git installed on your computer and set it up.
+
For more advanced tasks, you will need a Git installed on your computer.
 
There is excellent documentation for this available throughout the Internet, for example https://git-scm.com/documentation or https://docs.gitlab.com/ce/gitlab-basics/README.html.
 
There is excellent documentation for this available throughout the Internet, for example https://git-scm.com/documentation or https://docs.gitlab.com/ce/gitlab-basics/README.html.
 
It would make little sense to repeat these here.
 
It would make little sense to repeat these here.
Line 77: Line 77:  
Note that for most daily tasks, only about 5 Git operations are necessary to know about.
 
Note that for most daily tasks, only about 5 Git operations are necessary to know about.
   −
=== Troubleshoot ===
+
== Troubleshooting ==
Some users will see the  following message when they want to make a remote connection with SSH. (existing repository)
+
For technical issues you can contact [mailto:gitlab@socsci.ru.nl gitlab@socsci.ru.nl].
When you see the below message you will need to say yes.
     −
<pre style="background-color:#000; color:#fff;">
+
== Frequently asked questions ==
$ Warning: the ECDSA host key for 'gitlab.socsci.ru.nl' differs from the key for the IP address 'x.x.x.x'
  −
$ Offending key for IP in /home/user/.ssh/known_hosts:23 Matching host key in /home/user/.ssh/known_hosts:13
  −
$ Are you sure you want to continue connecting (yes/no)? yes
  −
</pre>
     −
Remote SSH connection should now be established.
+
=== Who has access to gitlab.socsci.ru.nl? ===
 +
Short answer: Anyone from Radboud University, and some people from other universities.
   −
For other technical issues you can contact [mailto:gitlab@socsci.ru.nl gitlab@socsci.ru.nl].
+
Longer answer: All employees and students of Radboud University have access (with their U-, S-, E- or F-number).
 +
If you log in the first time, a corresponding account will be created.
 +
In addition, you can request accounts for people from other universities, for example to collaborate with them on confidential projects.
 +
See External Users above.
   −
== Git Clients ==
+
=== Who can see my project(s) within GitLab? ===
 +
Short answer: You decide for each project (if you're the project owner).
 +
 
 +
Longer answer: GitLab distinguishes read-access within 3 layers, and you can choose for each project individually.
 +
TODO: Explain 3 layers with correct terms.
 +
 
 +
=== What can/should be stored on GitLab? ===
 +
Short answer: Scripts, documentation, theses, figures etc. '''No data please!''' For data, use https://data.donders.ru.nl/.
 +
 
 +
Longer answer: Git and GitLab are meant primarily for smaller amounts (Megabytes).
 +
Most features like comparing versions, only make sense with text-based files.
 +
Git keeps track of every single change you make in its history.
 +
It and never really forgets, unless you explicitly tell it to.
 +
That means Git repositories only grow larger, and even if you "delete" things, you can go back and un-delete them.
 +
That's a main feature, you have an "unlimited undo".
 +
But that feature makes also impractical for data - you can't really delete them, comparing versions of them makes little sense, and potentially you later want to invite more people or make the project available to everyone - but then you also would have to share the data since they're in the repository history.
 +
Finally, the server simply has limited capacity.
 +
For all these reasons, for data, use https://data.donders.ru.nl/.
   −
You can find the git clients for various operating systems [https://git-scm.com/downloads here].
  −
Additionally, you may be able to find a Git plugin for your code editor of choice.
      
<!-- ==References==
 
<!-- ==References==

Navigation menu