From 7d5ab67e639e25996adc2514a68ead846b96a7ec Mon Sep 17 00:00:00 2001
From: svenvanderburg <s.vanderburg@esciencecenter.nl>
Date: Tue, 2 Apr 2024 16:27:30 +0200
Subject: [PATCH 01/17] Add unfinished draft for documentation module

---
 modules/demo/types-of-documentation.md       | 29 ++++++++++++++++++++
 modules/demo/which-documentation-exercise.md | 29 ++++++++++++++++++++
 2 files changed, 58 insertions(+)
 create mode 100644 modules/demo/types-of-documentation.md
 create mode 100644 modules/demo/which-documentation-exercise.md

diff --git a/modules/demo/types-of-documentation.md b/modules/demo/types-of-documentation.md
new file mode 100644
index 00000000..35267cec
--- /dev/null
+++ b/modules/demo/types-of-documentation.md
@@ -0,0 +1,29 @@
+# Types of documentation and when to use them
+
+---
+
+## Why document projects?
+
+- Quickly get users started
+- Show how to use the software
+- Explain concepts behind the software
+- Describe internal machinery of a project
+
+## Types of documentation
+
+Documentation serves different goals, therefore there are different types: 
+- **Tutorials**: learning-oriented, allows the newcomer to get started
+- **How-to guides**: goal-oriented, shows how to solve a specific problem
+- **Explanation**: understanding-oriented, explains a concept
+- **Reference**: information-oriented, describes the machinery
+
+## README file: (how-to guide)
+- First thing a user/collaborator sees
+- Contains basic setup instructions and information about the project
+
+## In-code documentation (reference)
+- Technical documentation in the code
+- For example ```# comments```
+
+## API reference (reference)
+- API reference: detailed description of how each function/class in the code can be used
\ No newline at end of file
diff --git a/modules/demo/which-documentation-exercise.md b/modules/demo/which-documentation-exercise.md
new file mode 100644
index 00000000..ada850f6
--- /dev/null
+++ b/modules/demo/which-documentation-exercise.md
@@ -0,0 +1,29 @@
+# When to use which documentation?
+Joanne is working on her research software 'WeatherMap' that analyses and summarizes measurements from weather stations.
+
+Here is a list of possible forms of documentation:
+1. A basic README file containing: quick installation instructions, two lines explaining why the software was created, 
+two basic examples of how you can use the software.
+2. A tutorial: 'Finding unusual patterns in daily average temperatures using WeatherMap'.
+3. In-code documentation: Comments in her code that explain why she made certain implementation choices.
+5. API reference: Detailed description of each function/class of WeatherMap.
+6. Overview of components: A detailed overview of each component in the software
+7. User documentation: Extensive documentation on how users can use each of the functionalities of WeatherMap
+8. Naming: Logical names for functions, modules and classes so that it is immediately clear what the corresponding piece of code does
+
+
+For the following scenarios, which forms of documentation would you suggest Joanne to incorporate in her project:
+
+## Scenario A:
+Joanne just started her PhD and is the only one using WeatherMap to create results for her first paper. 
+She does not really care about anyone else using her software.
+
+## Scenario B:
+Joanne works together with a few other PhD students in her research group on the software. 
+She wants to make it easier for other researchers in her group to also adopt the software, 
+and finds it important that when she moves on to a different job that the software can be still be used and improved in her absence.
+
+## Scenario C:
+Joanne and her colleagues spend half of their time updating and improving WeatherMap. 
+They have a large community of users around the globe that depend on WeatherMap for their research.
+

From d5ca0086481ec3b33cb481aed05427d768f38320 Mon Sep 17 00:00:00 2001
From: Carlos Martinez <c.martinez@esciencecenter.nl>
Date: Wed, 12 Jun 2024 13:42:25 +0200
Subject: [PATCH 02/17] renaming demo to documentation

---
 modules/{demo => documentation}/types-of-documentation.md       | 0
 modules/{demo => documentation}/which-documentation-exercise.md | 0
 2 files changed, 0 insertions(+), 0 deletions(-)
 rename modules/{demo => documentation}/types-of-documentation.md (100%)
 rename modules/{demo => documentation}/which-documentation-exercise.md (100%)

diff --git a/modules/demo/types-of-documentation.md b/modules/documentation/types-of-documentation.md
similarity index 100%
rename from modules/demo/types-of-documentation.md
rename to modules/documentation/types-of-documentation.md
diff --git a/modules/demo/which-documentation-exercise.md b/modules/documentation/which-documentation-exercise.md
similarity index 100%
rename from modules/demo/which-documentation-exercise.md
rename to modules/documentation/which-documentation-exercise.md

From 4efb80ceaefbccf65d7b7f765a2a77dc7efd3a4d Mon Sep 17 00:00:00 2001
From: raar1 <raarichardson@gmail.com>
Date: Wed, 7 Aug 2024 15:41:03 +0200
Subject: [PATCH 03/17] Rebase onto main and use more standard naming

---
 ...ise.md => exercise-which-documentation.md} |  0
 modules/documentation/introduction.md         | 12 ++++
 modules/documentation/slides_documentation.md | 57 +++++++++++++++++++
 3 files changed, 69 insertions(+)
 rename modules/documentation/{which-documentation-exercise.md => exercise-which-documentation.md} (100%)
 create mode 100644 modules/documentation/introduction.md
 create mode 100644 modules/documentation/slides_documentation.md

diff --git a/modules/documentation/which-documentation-exercise.md b/modules/documentation/exercise-which-documentation.md
similarity index 100%
rename from modules/documentation/which-documentation-exercise.md
rename to modules/documentation/exercise-which-documentation.md
diff --git a/modules/documentation/introduction.md b/modules/documentation/introduction.md
new file mode 100644
index 00000000..1a7133ac
--- /dev/null
+++ b/modules/documentation/introduction.md
@@ -0,0 +1,12 @@
+
+# Reusability requires good documentation
+
+https://book.the-turing-way.org/reproducible-research/code-reuse/code-reuse-overview
+
+# README
+
+makeareadme.come
+
+# Popular tools foor documentation
+
+https://coderefinery.github.io/documentation/tools
diff --git a/modules/documentation/slides_documentation.md b/modules/documentation/slides_documentation.md
new file mode 100644
index 00000000..f5b294ea
--- /dev/null
+++ b/modules/documentation/slides_documentation.md
@@ -0,0 +1,57 @@
+<!-- .slide: data-state="title" -->
+
+# Documentation
+
+---
+
+<!-- .slide: data-state="standard" -->
+
+## What is documentation?
+
+- Provides context for your work
+- Allows your collaborators and future you to understand what has been done and why
+
+---
+
+<!-- .slide: data-state="standard" -->
+
+## Why document software?
+
+Make your software reusable:
+ 
+- A user should be able to run your software in the same way as you do now 
+- A user should be able to install your software
+- A contributor should be able to add or improve code
+
+---
+
+<!-- .slide: data-state="standard" -->
+
+## Documentation types
+
+User documentation
+- Purpose: What does the software do?
+- How can it be used: provide examples
+
+Developer documentation
+- How can your software be modified or extended?
+
+Deployment documentation
+- Hardware and software requirements
+
+---
+
+<!-- .slide: data-state="standard" -->
+
+## Documentation formats
+
+<!-- add visual with documentation format with increasing complexity -->
+
+- In-code: intended for contributors (comments, docstrings, ...)
+- README: simple text file, first thing that users/collaborators see
+- Websites, Wikis: 
+
+
+
+
+

From 2448be9c79549727250e562a37e06aad694553dc Mon Sep 17 00:00:00 2001
From: raar1 <raarichardson@gmail.com>
Date: Wed, 7 Aug 2024 16:04:23 +0200
Subject: [PATCH 04/17] Add metadata for exercises

---
 modules/documentation/exercise-which-documentation.md | 6 ++++++
 modules/documentation/{introduction.md => reading.md} | 0
 2 files changed, 6 insertions(+)
 rename modules/documentation/{introduction.md => reading.md} (100%)

diff --git a/modules/documentation/exercise-which-documentation.md b/modules/documentation/exercise-which-documentation.md
index ada850f6..701d85cc 100644
--- a/modules/documentation/exercise-which-documentation.md
+++ b/modules/documentation/exercise-which-documentation.md
@@ -1,3 +1,9 @@
+---
+title: When to use which documentation?
+type: exercise
+order: 4
+---
+
 # When to use which documentation?
 Joanne is working on her research software 'WeatherMap' that analyses and summarizes measurements from weather stations.
 
diff --git a/modules/documentation/introduction.md b/modules/documentation/reading.md
similarity index 100%
rename from modules/documentation/introduction.md
rename to modules/documentation/reading.md

From 7ea6692398259c64cc4a56e51498edb6fcb347ca Mon Sep 17 00:00:00 2001
From: raar1 <raarichardson@gmail.com>
Date: Wed, 7 Aug 2024 16:04:45 +0200
Subject: [PATCH 05/17] Move links in intro to further reading tab

---
 modules/documentation/reading.md | 17 +++++++++++------
 1 file changed, 11 insertions(+), 6 deletions(-)

diff --git a/modules/documentation/reading.md b/modules/documentation/reading.md
index 1a7133ac..c97edb0f 100644
--- a/modules/documentation/reading.md
+++ b/modules/documentation/reading.md
@@ -1,12 +1,17 @@
+---
+title: Further reading
+type: reading
+order: 5
+---
 
-# Reusability requires good documentation
+## Reusability requires good documentation
 
-https://book.the-turing-way.org/reproducible-research/code-reuse/code-reuse-overview
+<https://book.the-turing-way.org/reproducible-research/code-reuse/code-reuse-overview>
 
-# README
+## README
 
-makeareadme.come
+<https://makeareadme.com>
 
-# Popular tools foor documentation
+## Popular tools foor documentation
 
-https://coderefinery.github.io/documentation/tools
+<https://coderefinery.github.io/documentation/tools>

From f23df2a352126c932b44dd571165e421f3807a44 Mon Sep 17 00:00:00 2001
From: raar1 <raarichardson@gmail.com>
Date: Wed, 7 Aug 2024 16:05:28 +0200
Subject: [PATCH 06/17] Add slides metadata and update slide separators

---
 modules/documentation/slides_documentation.md | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

diff --git a/modules/documentation/slides_documentation.md b/modules/documentation/slides_documentation.md
index f5b294ea..63ee12b3 100644
--- a/modules/documentation/slides_documentation.md
+++ b/modules/documentation/slides_documentation.md
@@ -1,8 +1,14 @@
+---
+title: Documentation
+type: slides
+order: 1
+---
+
 <!-- .slide: data-state="title" -->
 
 # Documentation
 
----
+===
 
 <!-- .slide: data-state="standard" -->
 
@@ -11,7 +17,7 @@
 - Provides context for your work
 - Allows your collaborators and future you to understand what has been done and why
 
----
+===
 
 <!-- .slide: data-state="standard" -->
 
@@ -23,7 +29,7 @@ Make your software reusable:
 - A user should be able to install your software
 - A contributor should be able to add or improve code
 
----
+===
 
 <!-- .slide: data-state="standard" -->
 
@@ -39,7 +45,7 @@ Developer documentation
 Deployment documentation
 - Hardware and software requirements
 
----
+===
 
 <!-- .slide: data-state="standard" -->
 

From ed0a90d734c43cf5c85d247bc2b0e783e5befc7f Mon Sep 17 00:00:00 2001
From: raar1 <raarichardson@gmail.com>
Date: Wed, 7 Aug 2024 16:05:46 +0200
Subject: [PATCH 07/17] Add metadata for reading lesson

---
 modules/documentation/types-of-documentation.md | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/modules/documentation/types-of-documentation.md b/modules/documentation/types-of-documentation.md
index 35267cec..648fe9d3 100644
--- a/modules/documentation/types-of-documentation.md
+++ b/modules/documentation/types-of-documentation.md
@@ -1,6 +1,10 @@
-# Types of documentation and when to use them
-
 ---
+title: Types of documentation
+type: reading
+order: 3
+---
+
+# Types of documentation and when to use them
 
 ## Why document projects?
 
@@ -26,4 +30,4 @@ Documentation serves different goals, therefore there are different types:
 - For example ```# comments```
 
 ## API reference (reference)
-- API reference: detailed description of how each function/class in the code can be used
\ No newline at end of file
+- API reference: detailed description of how each function/class in the code can be used

From d42886e6af9650c9d337753efcf5b0195dcd5d38 Mon Sep 17 00:00:00 2001
From: raar1 <raarichardson@gmail.com>
Date: Wed, 7 Aug 2024 16:06:19 +0200
Subject: [PATCH 08/17] Add metadata for the Documentation module

---
 modules/documentation/index.md | 9 +++++++++
 1 file changed, 9 insertions(+)
 create mode 100644 modules/documentation/index.md

diff --git a/modules/documentation/index.md b/modules/documentation/index.md
new file mode 100644
index 00000000..02bf024a
--- /dev/null
+++ b/modules/documentation/index.md
@@ -0,0 +1,9 @@
+---
+title: Documentation
+category: Development
+order: 13
+abstract: Why should researchers document their code?
+author: eScience Center
+thumbnail: "thumbnail-fair-software.jpg"
+visibility: visible
+---

From acd0d022d05b554c419e2b821165140ad650ceb9 Mon Sep 17 00:00:00 2001
From: raar1 <raarichardson@gmail.com>
Date: Wed, 7 Aug 2024 16:06:47 +0200
Subject: [PATCH 09/17] Add draft learning objectives for Documentation module

---
 modules/documentation/info.md | 10 ++++++++++
 1 file changed, 10 insertions(+)
 create mode 100644 modules/documentation/info.md

diff --git a/modules/documentation/info.md b/modules/documentation/info.md
new file mode 100644
index 00000000..b4c2d9d1
--- /dev/null
+++ b/modules/documentation/info.md
@@ -0,0 +1,10 @@
+---
+title: Learning objectives
+type: info
+order: 0
+---
+
+Obtain the skills and knowledge necessary to address the following questions:
+- What is code documentation?
+- Why is documentation considered best practice in software development and how do I communicate that to researchers?
+- What are some of the ways code is documented in practice?

From 6aa670b1f2c37e3bd3547121affa4c4c3f021832 Mon Sep 17 00:00:00 2001
From: raar1 <raarichardson@gmail.com>
Date: Wed, 7 Aug 2024 16:18:23 +0200
Subject: [PATCH 10/17] Add thumbnail for documentation module

---
 modules/documentation/index.md                  |   2 +-
 .../media/thumbnail-documentation.jpg           | Bin 0 -> 30843 bytes
 2 files changed, 1 insertion(+), 1 deletion(-)
 create mode 100644 modules/documentation/media/thumbnail-documentation.jpg

diff --git a/modules/documentation/index.md b/modules/documentation/index.md
index 02bf024a..bed5c7cb 100644
--- a/modules/documentation/index.md
+++ b/modules/documentation/index.md
@@ -4,6 +4,6 @@ category: Development
 order: 13
 abstract: Why should researchers document their code?
 author: eScience Center
-thumbnail: "thumbnail-fair-software.jpg"
+thumbnail: "thumbnail-documentation.jpg"
 visibility: visible
 ---
diff --git a/modules/documentation/media/thumbnail-documentation.jpg b/modules/documentation/media/thumbnail-documentation.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..1c57f8b7edac1371a2ed93deefe1c8eaab739982
GIT binary patch
literal 30843
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
JT)u!=|Jf_+J~aRU

literal 0
HcmV?d00001


From eb50b8e93a8f9b00cfaefcd81290d918ce08c5f7 Mon Sep 17 00:00:00 2001
From: meronvermaas <37903632+meronvermaas@users.noreply.github.com>
Date: Mon, 8 Apr 2024 16:04:00 +0200
Subject: [PATCH 11/17] Create ex_suitability.md

create first draft of exercise about documentation types and requirements
---
 modules/documentation/ex_suitability.md | 51 +++++++++++++++++++++++++
 1 file changed, 51 insertions(+)
 create mode 100644 modules/documentation/ex_suitability.md

diff --git a/modules/documentation/ex_suitability.md b/modules/documentation/ex_suitability.md
new file mode 100644
index 00000000..49cd2665
--- /dev/null
+++ b/modules/documentation/ex_suitability.md
@@ -0,0 +1,51 @@
+# Exercise 1: What is suitable documentation?
+
+## Step 1: Choose a software project
+
+Choose a software project for this exercise, preferably one you are familiar with.
+
+If you don't have a project in mind, you can use one of the following:
+- [Xenon](https://research-software-directory.org/software/xenon)
+- [ESMValTool](https://research-software-directory.org/software/esmvaltool)
+- [RS-DAT](https://research-software-directory.org/projects/rs-dat)
+- [Haddock](https://research-software-directory.org/software/haddock3)
+- [worcs](https://cjvanlissa.github.io/worcs/index.html)
+
+## Step 2: Discuss type(s) of documentation
+
+*Look at the software repository or page in the Research Software Directory*
+
+- Is documentation for this project important? Why?
+- How would you describe a useful documentation for this project?
+- How can you motivate your colleagues to contribute to the documentation?
+
+*What type of documentation seems appropriate to you?*
+
+- User documentation
+- Developer documentation
+- Deployment documentation
+
+*Which content would you include?*
+The following (non-exhaustive) list of documentation items:
+
+- Purpose
+- Authors
+- License
+- Recommended citation
+- Copy-paste-able example to get started
+- Dependencies and their versions or version ranges
+- Installation instructions
+- Tutorials covering key functionality
+- Reference documentation (e.g. API) covering all functionality
+- How you want to be asked questions (mailing list or forum or chat or issue tracker)
+- Possibly a FAQ section
+- Contribution guide
+
+# Exercise 2: Improve a README
+
+The README file is usually the first thing users/collaborators see when visiting your GitHub repository.
+Use it to communicate important information about your project! For many smaller or mid-size projects, this is enough documentation.
+It’s not that hard to make a basic one, and it’s easy to expand as needed.
+
+- https://www.makeareadme.com/
+- https://gist.github.com/jxson/1784669

From 482970563b18ba7bbe55b56afc0106b68bb5412c Mon Sep 17 00:00:00 2001
From: raar1 <raarichardson@gmail.com>
Date: Wed, 7 Aug 2024 16:25:16 +0200
Subject: [PATCH 12/17] Keep the intro

---
 modules/documentation/introduction.md | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)
 create mode 100644 modules/documentation/introduction.md

diff --git a/modules/documentation/introduction.md b/modules/documentation/introduction.md
new file mode 100644
index 00000000..34abef0b
--- /dev/null
+++ b/modules/documentation/introduction.md
@@ -0,0 +1,18 @@
+
+# Reusability requires good documentation
+
+https://book.the-turing-way.org/reproducible-research/code-reuse/code-reuse-overview
+
+# Documentation types and formats
+
+user, development, deployment
+
+## README
+
+What is a README file, how to write a good README
+
+https://makeareadme.com
+
+## Popular tools foor building more complex documentation
+
+https://coderefinery.github.io/documentation/tools

From b7fd5febd3484f7afd4672f54ee5ec63004eb289 Mon Sep 17 00:00:00 2001
From: Max Paulus <paulmaxus@gmail.com>
Date: Tue, 9 Apr 2024 17:18:23 +0200
Subject: [PATCH 13/17] split exercise

---
 modules/documentation/ex_readme.md      |  8 ++++++++
 modules/documentation/ex_suitability.md | 12 ++----------
 2 files changed, 10 insertions(+), 10 deletions(-)
 create mode 100644 modules/documentation/ex_readme.md

diff --git a/modules/documentation/ex_readme.md b/modules/documentation/ex_readme.md
new file mode 100644
index 00000000..be7581e6
--- /dev/null
+++ b/modules/documentation/ex_readme.md
@@ -0,0 +1,8 @@
+# Improve a README
+
+The README file is usually the first thing users/collaborators see when visiting your GitHub repository.
+Use it to communicate important information about your project! For many smaller or mid-size projects, this is enough documentation.
+It’s not that hard to make a basic one, and it’s easy to expand as needed.
+
+- https://www.makeareadme.com/
+- https://gist.github.com/jxson/1784669
diff --git a/modules/documentation/ex_suitability.md b/modules/documentation/ex_suitability.md
index 49cd2665..4f9ae8bc 100644
--- a/modules/documentation/ex_suitability.md
+++ b/modules/documentation/ex_suitability.md
@@ -1,4 +1,4 @@
-# Exercise 1: What is suitable documentation?
+# What is suitable documentation?
 
 ## Step 1: Choose a software project
 
@@ -6,6 +6,7 @@ Choose a software project for this exercise, preferably one you are familiar wit
 
 If you don't have a project in mind, you can use one of the following:
 - [Xenon](https://research-software-directory.org/software/xenon)
+- [Democracy Topic Modelling](https://research-software-directory.org/software/democracy-topic-modelling)
 - [ESMValTool](https://research-software-directory.org/software/esmvaltool)
 - [RS-DAT](https://research-software-directory.org/projects/rs-dat)
 - [Haddock](https://research-software-directory.org/software/haddock3)
@@ -40,12 +41,3 @@ The following (non-exhaustive) list of documentation items:
 - How you want to be asked questions (mailing list or forum or chat or issue tracker)
 - Possibly a FAQ section
 - Contribution guide
-
-# Exercise 2: Improve a README
-
-The README file is usually the first thing users/collaborators see when visiting your GitHub repository.
-Use it to communicate important information about your project! For many smaller or mid-size projects, this is enough documentation.
-It’s not that hard to make a basic one, and it’s easy to expand as needed.
-
-- https://www.makeareadme.com/
-- https://gist.github.com/jxson/1784669

From c81ec2df3c56b01dfafdd2916087526d7e03594d Mon Sep 17 00:00:00 2001
From: Robin Richardson <raar1@users.noreply.github.com>
Date: Wed, 7 Aug 2024 14:55:29 +0200
Subject: [PATCH 14/17] Update modules/documentation/ex_readme.md

Co-authored-by: Carlos Martinez <c.martinez@esciencecenter.nl>
---
 modules/documentation/ex_readme.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/modules/documentation/ex_readme.md b/modules/documentation/ex_readme.md
index be7581e6..e9c0ab91 100644
--- a/modules/documentation/ex_readme.md
+++ b/modules/documentation/ex_readme.md
@@ -1,4 +1,4 @@
-# Improve a README
+# Include a README file
 
 The README file is usually the first thing users/collaborators see when visiting your GitHub repository.
 Use it to communicate important information about your project! For many smaller or mid-size projects, this is enough documentation.

From 46b26904fadb3dc2aee660d7d7774d5cb1ae5043 Mon Sep 17 00:00:00 2001
From: raar1 <raarichardson@gmail.com>
Date: Wed, 7 Aug 2024 16:31:27 +0200
Subject: [PATCH 15/17] Add metadata for exercises

---
 modules/documentation/ex_readme.md      |  7 +++++++
 modules/documentation/ex_suitability.md |  6 ++++++
 modules/documentation/introduction.md   | 18 ------------------
 modules/documentation/reading.md        |  2 +-
 4 files changed, 14 insertions(+), 19 deletions(-)
 delete mode 100644 modules/documentation/introduction.md

diff --git a/modules/documentation/ex_readme.md b/modules/documentation/ex_readme.md
index e9c0ab91..4f04b07a 100644
--- a/modules/documentation/ex_readme.md
+++ b/modules/documentation/ex_readme.md
@@ -1,3 +1,10 @@
+---
+title: Include a README file
+type: exercise
+order: 4
+---
+
+
 # Include a README file
 
 The README file is usually the first thing users/collaborators see when visiting your GitHub repository.
diff --git a/modules/documentation/ex_suitability.md b/modules/documentation/ex_suitability.md
index 4f9ae8bc..1debce96 100644
--- a/modules/documentation/ex_suitability.md
+++ b/modules/documentation/ex_suitability.md
@@ -1,3 +1,9 @@
+---
+title: What is suitable documentation?
+type: exercise
+order: 4
+---
+
 # What is suitable documentation?
 
 ## Step 1: Choose a software project
diff --git a/modules/documentation/introduction.md b/modules/documentation/introduction.md
deleted file mode 100644
index 34abef0b..00000000
--- a/modules/documentation/introduction.md
+++ /dev/null
@@ -1,18 +0,0 @@
-
-# Reusability requires good documentation
-
-https://book.the-turing-way.org/reproducible-research/code-reuse/code-reuse-overview
-
-# Documentation types and formats
-
-user, development, deployment
-
-## README
-
-What is a README file, how to write a good README
-
-https://makeareadme.com
-
-## Popular tools foor building more complex documentation
-
-https://coderefinery.github.io/documentation/tools
diff --git a/modules/documentation/reading.md b/modules/documentation/reading.md
index c97edb0f..df1ec404 100644
--- a/modules/documentation/reading.md
+++ b/modules/documentation/reading.md
@@ -12,6 +12,6 @@ order: 5
 
 <https://makeareadme.com>
 
-## Popular tools foor documentation
+## Popular tools foor building more complex documentation
 
 <https://coderefinery.github.io/documentation/tools>

From e0adcb3a075f3fc0d055421864448fc7e8525525 Mon Sep 17 00:00:00 2001
From: raar1 <raarichardson@gmail.com>
Date: Wed, 7 Aug 2024 17:04:28 +0200
Subject: [PATCH 16/17] Add some slides from the digital-skills-slides.
 Therefore add Luisa and Barbara as authors for this slide deck.

---
 modules/documentation/slides_documentation.md | 158 +++++++++++++++++-
 1 file changed, 157 insertions(+), 1 deletion(-)

diff --git a/modules/documentation/slides_documentation.md b/modules/documentation/slides_documentation.md
index 63ee12b3..24ce70da 100644
--- a/modules/documentation/slides_documentation.md
+++ b/modules/documentation/slides_documentation.md
@@ -2,6 +2,7 @@
 title: Documentation
 type: slides
 order: 1
+author: Luisa Orozco, Barbara Vreede, Jaro Camphuijsen, Carlos Martinez, Max Paulus, Robin Richardson
 ---
 
 <!-- .slide: data-state="title" -->
@@ -55,9 +56,164 @@ Deployment documentation
 
 - In-code: intended for contributors (comments, docstrings, ...)
 - README: simple text file, first thing that users/collaborators see
-- Websites, Wikis: 
+- Websites, Wikis 
 
+===
+
+<!-- .slide: data-state="standard"  -->
+
+## A good README file
+
++ README file is first thing a user/collaborator sees
++ What should be included in README files?
+<ul>
+  <li contenteditable="true">...</li>
+  <li contenteditable="true">...</li>
+  <li contenteditable="true">...</li>
+  <li contenteditable="true">...</li>
+  <li contenteditable="true">...</li>
+  <li contenteditable="true">...</li>
+  <li contenteditable="true">...</li>
+</ul>
+
+
+Note:
++ A descriptive project title
++ Motivation (why the project exists) and basics
++ Installation / How to setup
++ Copy-pasteable quick start code example
++ Usage reference (if not elsewhere)
++ Recommended citation if someone uses it
++ Other related tools ("see also")
++ Contact information for the developer(s)
++ License information
++ Contributing guidelines
+
+===
+
+<!-- .slide: data-state="standard"  -->
+
+## Why write in-code documentation?
+
+In-code documentation:
+
++ Makes code more understandable
++ Explains decisions we made
+
+===
+
+<!-- .slide: data-state="standard"  -->
+
+## When **not** to use in-code documentation?
+
++ When the code is self-explanatory
++ To replace good variable/function names
++ To replace version control
++ To keep old (zombie) code around
+
+===
+
+<!-- .slide: data-state="standard"  -->
+
+## Readable code vs commented code
+
+```python=
+# convert from degrees celsius to fahrenheit
+def convert(d):
+    return d * 5 / 9 + 32
+```
+vs
+```python=
+def celsius_to_fahrenheit(degrees):
+    return degrees * 5 / 9 + 32
+```
+
+===
+
+<!-- .slide: data-state="standard"  -->
+
+## What makes a good comment?
+
+**Comment A**
+
+<pre data-id="code-animation"><code style="overflow: hidden;" data-trim class="python">
+# Now we check if temperature is larger than -50:
+if temperature > -50:
+    print('do something')
+</code></pre>
+
+**Comment B**
+
+<pre data-id="code-animation"><code style="overflow: hidden;" data-trim class="python">
+# We regard temperatures below -50 degrees as measurement errors
+if temperature > -50:
+    print('do something')
+</code></pre>
 
+How are these different? Which one do you prefer?
 
+===
+
+<!-- .slide: data-state="standard"  -->
+
+## Docstrings: a special kind of comment
+
+```python=
+def celsius_to_fahrenheit(degrees):
+  """Convert degrees Celsius to degrees Fahrenheit."""
+  return degrees * 5 / 9 + 32
+```
+
+Why is this OK?
+
+Note:
+Docstrings can be used to generate user documentation.
+They are accessible outside the code.
+They follow a standardized syntax.
+
+===
+
+<!-- .slide: data-state="standard"  -->
+
+## In-code commenting: key points
+
++ Explicit, descriptive naming already provides important documentation.
++ Comments should describe the why for your code, not the what.
++ Writing docstrings is an easy way to write documentation while you code, as they are accessible outside the code itself.
+
+===
+
+<!-- .slide: data-state="standard"  -->
+
+## User/API documentation
+
++ What if a README file is not enough?
++ How do I easily create user documentation?
+
+===
+
+<!-- .slide: data-state="standard"  -->
+
+## Tools
+
++ **Sphinx** (documentation generator)
+  - creates nicely-formatted HTML pages out of .md or .rst files
+  - programming language independent
++ **Github pages** (deploy your documentation)
+  - set up inside your GitHub repository
+  - automatically deploys your Sphinx-generated documentation
+
+===
+
+<!-- .slide: data-state="standard" -->
 
+## Take-home message
 
++ Depending on the purpose and state of the project documentation needs to meet different criteria.
++ Documentation can take different shapes:
+  + Readable code
+  + In-code comments
+  + Docstrings
+  + README files
+  + Tutorials/notebooks
++ Documentation is a vital part of a project, and should be kept and created alongside the corresponding code.

From 76105549f67e56bcb8efc2a761c2e7572db6857a Mon Sep 17 00:00:00 2001
From: raar1 <raarichardson@gmail.com>
Date: Wed, 7 Aug 2024 17:06:32 +0200
Subject: [PATCH 17/17] Remove examples Jaro didn't like

---
 modules/documentation/ex_suitability.md | 2 --
 1 file changed, 2 deletions(-)

diff --git a/modules/documentation/ex_suitability.md b/modules/documentation/ex_suitability.md
index 1debce96..0909ce8d 100644
--- a/modules/documentation/ex_suitability.md
+++ b/modules/documentation/ex_suitability.md
@@ -11,10 +11,8 @@ order: 4
 Choose a software project for this exercise, preferably one you are familiar with.
 
 If you don't have a project in mind, you can use one of the following:
-- [Xenon](https://research-software-directory.org/software/xenon)
 - [Democracy Topic Modelling](https://research-software-directory.org/software/democracy-topic-modelling)
 - [ESMValTool](https://research-software-directory.org/software/esmvaltool)
-- [RS-DAT](https://research-software-directory.org/projects/rs-dat)
 - [Haddock](https://research-software-directory.org/software/haddock3)
 - [worcs](https://cjvanlissa.github.io/worcs/index.html)