diff --git a/chapters/links.md b/chapters/links.md
index f2b2c012b193fb4bf583810446e7066ec482eda3..f8895ea41ccba318b4d3445d943fc52ad016f489 100644
--- a/chapters/links.md
+++ b/chapters/links.md
@@ -1,18 +1,15 @@
 
 ## Helpful Links and References
 
-- EURISE-network technical-reference:\
-<https://github.com/eurise-network/technical-reference>
+This section collects resources we find useful.
+Feel free to add more if you happen to stumble upon anything interesting!
 
-- DHTech -- An international grass-roots community of Digital Humanities software engineers:\
-<https://dh-tech.github.io>
+### Other References
 
+- EURISE-network technical-reference:\
+<https://github.com/eurise-network/technical-reference>
 - The Software Sustainability Institute, Guidelines and Publications:\
 <https://www.software.ac.uk>
-
-- The Joel Test: 12 Steps to Better Code:\
-<https://www.joelonsoftware.com/2000/08/09/the-joel-test-12-steps-to-better-code>
-
 - Software Quality Guidelines:\
 <https://github.com/CLARIAH/software-quality-guidelines>
 
@@ -22,5 +19,17 @@
 - Netherlands eScience Center Guide\
 <https://guide.esciencecenter.nl>
 
+### Communities
+
+- DHTech -- An international grass-roots community of Digital Humanities software engineers:\
+<https://dh-tech.github.io>
+
+### Software Quality
+
 - The Twelve-Factor App:\
 <https://12factor.net>
+- The Joel Test: 12 Steps to Better Code:\
+<https://www.joelonsoftware.com/2000/08/09/the-joel-test-12-steps-to-better-code>
+- An introduction to clean code:\
+<https://www.freecodecamp.org/news/clean-coding-for-beginners/>
+[Freecodecamp](https://www.freecodecamp.org) has lots of other interesting articles, too, so check them out!
diff --git a/chapters/onboarding.md b/chapters/onboarding.md
index 3af9faeee85111e66967b0bb5da526183d945219..8e3e14a798cecb9da054cd5508b3dde0411e7afd 100644
--- a/chapters/onboarding.md
+++ b/chapters/onboarding.md
@@ -40,10 +40,22 @@ We assume a basic familiarity with basal technologies such as XML.
 
 ### Mailing 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)
+#### Of General Interest
+
+- [de-RSE](https://de-rse.org/de/):
+This is where other research software engineers try to form a community.
+Lots of job offers.
+- [RfII](http://www.rfii.de/de/start/):
+The "Rat für Informationsinfrastrukturen" uses this mailing list to give information about recent trends in digitalization in Germany, both in industry and research.
+It's a good starting point to get a general grasp of what's going on in digital Germany.
+
+#### By Software
+
+- [eXist-db (eXist open mailing list)](https://sourceforge.net/p/exist/mailman/):
+A place to ask questions about eXist-db.
+The main discussion takes place at [Slack](https://exist-db.slack.com/), though.
+- relevant [TEI-lists](https://tei-c.org/support/#tei-l):
+A place to ask your questions about TEI.
 
 ### Services by the Computing Center (GWDG)