Changes

Jump to navigation Jump to search

Gitlab Social Sciences (view source)

Revision as of 17:06, 15 February 2019

8,727 bytes added ,  17:06, 15 February 2019
m
Shorter initial sentences
Line 1: Line 1: −
#REDIRECT [[Gitlab Social Sciences]]
+
{{Infobox software
 +
| name                  = Gitlab Social Sciences
 +
| logo                  = wm_no_bg.svg
 +
| logo size              = 150px
 +
| screenshot            =
 +
| caption                =
 +
| developer              =
 +
| released              = <!-- {{Start date and age|YYYY|MM|DD|df=yes}} -->
 +
| discontinued          =
 +
| latest release version =
 +
| latest release date    = <!-- {{Start date and age|YYYY|MM|DD|df=yes}} -->
 +
| latest preview version =
 +
| latest preview date    = <!-- {{Start date and age|YYYY|MM|DD|df=yes}} -->
 +
| installed version      =
 +
| installed version date = <!-- {{Start date and age|YYYY|MM|DD|df=yes}} -->
 +
| platform              = Microsoft Windows, MacOSX, Linux
 +
| license                = [https://en.wikipedia.org/wiki/MIT_License MIT License]
 +
| website                = [https://gitlab.socsci.ru.nl/ gitlab.socsci.ru.nl]
 +
| resources              = <!-- Infobox -->
 +
  {{Infobox tsg
 +
    | child              = yes
 +
    | downloads          = {{bulleted list
 +
        | [https://git-scm.com/downloads Git Download]
 +
        | [https://git-scm.com/downloads/guis Git Desktop Clients]
 +
    }}
 +
    | manuals            = {{bulleted list
 +
        | [https://git-scm.com/documentation Git] Git Documentation.
 +
        | [http://doc.gitlab.com/ce/ Gitlab Documentation]
 +
        | [https://www.youtube.com/watch?v=7p0hrpNaJ14 Video Tutorial]
 +
    }}
 +
  }}
 +
}}
 +
 
 +
The [https://gitlab.socsci.ru.nl Social Sciences GitLab server] offers [[wikipedia:Git|Git]] repository management, code reviews, issue tracking, and wikis.
 +
With the [[Mattermost Social Sciences]] you can chat with your colleagues and interact with your projects.
 +
 
 +
<!-- Table of Contents will be generated here -->
 +
 
 +
== Features ==
 +
With GitLab you can easily manage your projects, synchronize your code between computers, or create wiki-pages for documentation.
 +
Whether you write code or a paper, you can review, deploy, or document your project together with others.
 +
You can create at least 50 projects, make them private or share them with your lab members, or even the entire Internet.
 +
With [[Mattermost Social Sciences]] you can chat with your colleagues and even manage the project through chat commands.
 +
 
 +
Think of GitLab as a "Facebook" around your projects.
 +
Similar services include e.g. [https://github.com GitHub.com] or [https://gitlab.com GitLab.com] (which also runs the GitLab software on their servers).
 +
In contrast to these services, GitLab Social Sciences is self-hosted on a server on the Radboud campus.
 +
That means we determine our own terms of use; for example, you can get private projects for free - on GitHub, you would have to pay.
 +
 
 +
Note that there's another self-hosted [https://gitlab.science.ru.nl GitLab service running at the Faculty of Science].
 +
Anyone who has a "science login" can also use this service; it's running the same software - just the login page looks different.
 +
 
 +
== Requirements ==
 +
1. A GitLab account to log in at https://gitlab.socsci.ru.nl:
 +
* Everyone from Radboud University can login (with their U-, S-, E- or F-number). Members of UMC with Z-numbers have to request external accounts, see below.
 +
* External users can ask for an account and then login with their username (switch to the "Standard" tab in the Sign-In page).
 +
2. For more than the most basic tasks, you'll also need to install [https://git-scm.com/downloads Git] on your computer.
 +
 
 +
== Login for external users ==
 +
External user accounts should be requested from a member of Radboud University.
 +
If you want to allow people without RU account to join your Mattermost team or GitLab project, please request an account by sending an email to
 +
[mailto:gitlab@socsci.ru.nl gitlab@socsci.ru.nl].
 +
Please provide the full name of the user, a requested username, and a valid email address, preferably from the university or organization the person is working at.
 +
 
 +
''Note that with an external account, the user has to switch to the "Standard" tab on the Sign-In page.''
 +
From GitLab's point of view, all accounts have the same rights and restrictions.
 +
Once logged in, there are no further differences.
 +
 
 +
== Setup, Configuration and Usage of Git clients ==
 +
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.
 +
It would make little sense to repeat these here.
 +
There are many graphical user interfaces available for every major operating system.
 +
In addition, many development software packages (including Matlab) are aware of Git repositories and you can set them up to work with GitLab.
 +
Note that for most daily tasks, only about 5 Git operations are necessary to know about.
 +
 
 +
== Frequently asked questions ==
 +
 
 +
=== Who has access to gitlab.socsci.ru.nl? ===
 +
Short answer: Anyone from Radboud University, and some people from other universities.
 +
 
 +
Longer answer: All employees and students of Radboud University have access (with their U-, S-, E- or F-number).
 +
Members from Radboud UMC with Z-numbers have to request external accounts, see above.
 +
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.
 +
 
 +
=== 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.
 +
Each project can be either
 +
* ''private'': only you and your hand-picked users (and groups) can read it,
 +
* or ''internal'': anyone with a GitLab account can read it,
 +
* or ''public'': anyone on the Internet can read it.
 +
For more information, see https://gitlab.socsci.ru.nl/help/public_access/public_access#visibility-of-projects.
 +
 
 +
=== What can/should be stored on GitLab? ===
 +
Short answer: Scripts, documentation, theses, figures etc. '''No research data please!''' For research data, use https://data.donders.ru.nl/.
 +
For some niche cases, GitLab's Large File Storage (LFS) might be useful, see below.
 +
 
 +
Longer answer: Git and GitLab are meant primarily for smaller amounts of data (think Megabytes, not Gigabytes).
 +
Most features, like comparing versions, only really make sense with changing text-based files.
 +
Git keeps track of every change you make in its history, and thus content is never really deleted.
 +
That means Git repositories only grow larger, and even if you "delete" files, you can go back and un-delete them.
 +
That's a main feature, you get an "unlimited undo" for all kinds of files (and across different editors and computers).
 +
 
 +
Keeping an unchangeable history makes it impractical for binary data - you can't really delete them, comparing versions of them makes little sense.
 +
And potentially you later want to make the project available to more people - but maybe without sharing all data.
 +
For these reasons, please use https://data.donders.ru.nl/ for your research data.
 +
 
 +
In case you need certain large data files for your development, GitLab offers Large File Storage (LFS).
 +
Please only use this feature after careful consideration, for files that are integral to your project and for which no other data repository makes sense.
 +
Note that you need to install the LFS extension on your local machine to use this.
 +
For more documentation, please refer to https://docs.gitlab.com/ce/workflow/lfs/manage_large_binaries_with_git_lfs.html.
 +
 
 +
=== What happens to my GitLab projects when I leave? ===
 +
First, if you use Git on your computer, you will have the entire history also locally on your machine.
 +
Without a valid RU account, also your GitLab access will become inactive.
 +
If you want to retain access, you are welcome to ask for an External User account.
 +
There are currently no plans to delete any content when an account becomes inactive.
 +
 
 +
=== Who decides the GitLab policies? ===
 +
Since the GitLab service is still quite new, not all policies have been fully been worked out yet.
 +
You are welcome to contribute to our Terms Of Use and shape the future of the service.
 +
We are certainly open to any suggestions, and want to make it as useful as possible for everyone.
 +
Just send an email to [mailto:gitlab@socsci.ru.nl gitlab@socsci.ru.nl].
 +
 
 +
 
 +
== Troubleshooting ==
 +
For technical issues you can contact [mailto:gitlab@socsci.ru.nl gitlab@socsci.ru.nl].
 +
 
 +
=== Known issues ===
 +
 
 +
* Login does not work with (some) versions of the Safari web browser. ''The only solution we know of is to use another browser, sorry for the inconvenience.''
 +
 
 +
<!-- ==References==
 +
{{reflist}} -->
 +
 
 +
==External Links== <!-- Optional -->
 +
*{{Official website|http://www.gitlab.com}}
Retrieved from "http://tsgdoc.socsci.ru.nl/index.php/Special:MobileDiff/3321...4738"

Navigation menu