From 6f4c0f3707b1ca5cdbb96f3389ef9dc665e75622 Mon Sep 17 00:00:00 2001
From: Michelle Weidling <weidling@sub.uni-goettingen.de>
Date: Mon, 8 Jun 2020 11:15:21 +0200
Subject: [PATCH] style: format according to guidelines, add some links

---
 rdd-technical-reference.md | 41 ++++++++++++++++----------------------
 1 file changed, 17 insertions(+), 24 deletions(-)

diff --git a/rdd-technical-reference.md b/rdd-technical-reference.md
index 82bc6c7..cfc5a27 100644
--- a/rdd-technical-reference.md
+++ b/rdd-technical-reference.md
@@ -579,21 +579,16 @@ __Actions to Be Taken in RDD:__
 
 # FE-Onboarding
 
-This section focuses on the specific needs and requirements of developers new
-to the department. Please also refer to any of the general information on
-onboarding within the department, as well as the departmental mentoring
-program. This includes skills and tools developers need,
-as well as a checklist of the basic repos and groups new developers should
-be granted access to. A list of relevant and useful mailing lists new
-developers ought to consider subscribing to is provided at the end of the
-section. Developers should keep in mind that a DARIAH-account is needed to
-access some of the commonly used infrastructure.
+This section focuses on the specific needs and requirements of developers new to the department.
+Please also refer to any of the general information on onboarding within the department, as well as the departmental mentoring program.
+This includes skills and tools developers need, as well as a checklist of the basic repos and groups new developers should be granted access to.
+A list of relevant and useful mailing lists new developers ought to consider subscribing to is provided at the end of the section.
+Developers should keep in mind that a DARIAH-account is needed to access some of the commonly used infrastructure.
 
 ## Skills & Tools
 
-Here you will find a list of skills and tools that a developer will likely
-need at one point or another during their tenure at FE. We assume a basic
-familiarity with basal technologies such as XML.
+Here you will find a list of skills and tools that a developer will likely need at one point or another during their tenure at FE.
+We assume a basic familiarity with basal technologies such as XML.
 
 - Ant
 - GitLab CI/CD
@@ -604,7 +599,7 @@ familiarity with basal technologies such as XML.
 - (Lucene-)Indices
 - SADE
 
-## Repos & Groups
+### Repos & Groups
 
 - The departmental group at GitHub: `https://github.com/subugoe/teams/fe`
 - The departmental group at GitLab.gwdg.de: `https://gitlab.gwdg.de/fe`
@@ -617,18 +612,16 @@ familiarity with basal technologies such as XML.
 - Kanboard-user group FE
 - (possibly project-related SUB-intranet-spaces)
 
-## Mailing Lists
+### Mailing Lists
 
-- eXist-db (eXist open mailing list)
-- de-RSE
-- RfII
-- relevant TEI-lists
+- [eXist-db (eXist open mailing list)](https://sourceforge.net/p/exist/mailman/)
+- [de-RSE](https://de-rse.org/de/)
+- [RfII](http://www.rfii.de/de/start/)
+- relevant [TEI-lists](https://tei-c.org/support/#tei-l)
 
-## Further Reading
+### Further Reading
 
-Beyond the points listed above, developers should consider looking into the
-media below for any further information that is of professional or personal
-interest.
+Beyond the points listed above, developers should consider looking into the media below for any further information that is of professional or personal interest.
 
-- DH-FE-Zoterobibliothek
-- Heise.de, Golem.de, etc.
+- ["Doing Digital Humanities", a Zotero library](https://www.zotero.org/groups/113737/doing_digital_humanities_-_a_dariah_bibliography?)
+- <heise.de>, <golem.de>, etc.
-- 
GitLab