Merge pull request #133 from esciencecenter-digital-skills/minor-post…

…-day1-updates

Minor post day1 updates

modules/citation/info.md

@@ -4,7 +4,8 @@ type: info
 order: 0
 ---
 
-Obtain the skills and knowledge necessary to address the following questions:
+In this module you will learn to answer the following questions:
+
 - Why is it important to cite research software?
 - What are the principles of software citation?
 - How do I communicate the importance of citing software to researchers?

modules/documentation/info.md

@@ -4,7 +4,8 @@ type: info
 order: 0
 ---
 
-Obtain the skills and knowledge necessary to address the following questions:
+In this module you will learn to answer 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?

modules/licenses/info.md

@@ -4,7 +4,7 @@ type: info
 order: 0
 ---
 
-Obtain the skills and knowledge necessary to address the following questions:
+In this module you will learn to answer the following questions:
 
 - What is a software license? What is copyright?
 - How to legally use software made by others in your organisation?

modules/publication/info.md

@@ -4,7 +4,8 @@ type: info
 order: 0
 ---
 
-Obtain the skills and knowledge necessary to address the following questions:
+In this module you will learn to answer the following questions:
+
 - What does publishing software mean?
 - Why should researchers publish their software?
 - Where should researchers publish their software?

modules/researchsoftware/info.md

@@ -4,7 +4,8 @@ type: info
 order: 0
 ---
 
-Obtain the skills and knowledge necessary to address the following questions:
-- What is the difference between "research software" and "software in research"?
-- What is the difference between software and data?
+In this module you will learn to answer the following questions:
+
+- What are the similarities and differences between software and data?
+- What is the difference between "Research Software" and "software in research"?
 - Why are these distinctions important and useful? How do I effectively communicate that to researchers?

modules/researchsoftware/slides-researchsoftware.md

@@ -129,7 +129,7 @@ By defining research software:
 
 - Software is an important part of research
 - Not all software used in research is Research Software
-- Defining "Research Software" provides recognzition in the research community
+- Defining "Research Software" provides recognition in the research community
 
 ===
 

modules/researchsoftware/slides-software.md

@@ -151,12 +151,12 @@ Software can be ...
 - stored as bits
 - read, loaded, and processed
 - input and/or output
+- can be assigned a DOI, licence, etc
 
 <!-- Speaker notes -->
 Note:
 - Software is stored as bits and read from disk, loaded into memory, and processed similar to other types of data. 
 - Software can be input, and software can be output. In fact, one of the major breakthroughs in computer science was when people realized that the instructions of the machine could be handled and stored the same as the data that it operated on. 
-- And fits all 3 dictionary definitions of data quite well. 
 
 ==
 
@@ -181,10 +181,6 @@ Software is...
 Note:
 While technically, software is a special kind of data (in that it is representation of information in a digital state), they are in essence quite different.
 
-Software and data both are digital objects, sharing certain characteristics: they can be assigned a DOI, and they can have a license.
-
-Software is quite different from data, however. Consider:
-
 - Complexity; it is not a single file, but a collection of files that are interconnected and multi-layered, and do not necessarily stand on their own. Software is also the result of a creative process that provides a tool to do something, and not the result of a measurement or observation.
 - Interdependence; software is often built using other software, and rarely built completely from scratch. This makes it dependent on other existing applications, which themselves may also change over time. In the context of research software it also often depends on the data, data formats, data standards, metadata, etc, which also change when new equipment becomes available.
 - Executability; software is in its dryest form a set of instructions that can be an archive of a procedure. However, the main goal of software is that these instructions can be executed. While most forms of data can stand on their own (e.g. I can look at the list of ages of all the people in a room and make conclusions about average age, etc.), software cannot be directly interpreted (only in the context of what it does).

modules/softwarelandscape/info.md

@@ -4,7 +4,8 @@ type: info
 order: 0
 ---
 
-Obtain the skills and knowledge necessary to address the following questions:
+In this module you will learn to answer the following questions:
+
 - Why do researchers write software themselves?
 - What problems arise because of this?
-- What initiatives exist to tackle these issues?
+- What initiatives exist to tackle these issues?

modules/softwarelandscape/slides.md

@@ -36,7 +36,7 @@ order: 1
 
 - **So** researchers often write software themselves 
 - **But** researchers are not trained as software engineers
-- **And** Software is not (yet) regarded as valuable research output
+- **And** software is not (yet) regarded as valuable research output
 
 Note:
 First is a true statement. 

modules/softwaremanagementplans/info.md

@@ -4,7 +4,7 @@ type: info
 order: 0
 ---
 
-Obtain the skills and knowledge necessary to address the following questions:
+In this module you will learn to answer the following questions:
 
 - What is a software management plan?
 - Why are software management plans important for science?

modules/softwaremanagementplans/slides-smp.md

@@ -302,6 +302,7 @@ Finally, a *risk analysis* should be performed: for instance, are there privacy
   - Resources for information and support
   - Institution-specific regulations
   - Institution-specific resources available
+  - Who to contact for clarification/further information
 - Include an assessment rubric (e.g. with (un)acceptable answers)
 
 Note:
@@ -341,7 +342,7 @@ The SMP Guide distinguishes software with low, medium, and high management needs
 - Single purpose scripts
 - Developer is the primary user
 - Performs limited function:
-  - Analyses a single experiment or dataset
+  - Analyses a single/few experiment(s) or dataset(s)
   - Automates a routine task
 
 Note:
@@ -386,7 +387,7 @@ Software management planning should include providing information on archiving a
 
 ## SMP level: high
 
-- Mission critical software
+- "Mission critical" software
 - High standards required for reliability
 - Absence or replacement of the software would threaten research
 - Software that is continually in use:
@@ -412,6 +413,7 @@ Thus, maintenance strategies, including funding and/or community development pla
 - **Purpose**: what is the reason or expected end-use for the software?
 - **Reliability**: what is the effect of software failure and/or non-maintenance?
 - **Maintenance**: what is the long-term effort needed to maintain the software?
+- **Lifetime**: How long do you expect (wish) the software to remain in use?
 
 Check the Practical Guide: [doi:10.5281/zenodo.7038280](https://doi.org/10.5281/zenodo.7038280)
 

modules/testing/info.md

@@ -4,7 +4,9 @@ type: info
 order: 0
 ---
 
+In this module you will learn to answer the following questions:
+
 - Appreciate the importance of testing software
 - Understand the various benefits of testing
 - Understand the types of tests and what info they convey
-- Get familiar with the idea of continuous integration and its importance
+- Get familiar with the idea of continuous integration and its importance

modules/version-control/info.md

@@ -4,10 +4,11 @@ type: info
 order: 0
 ---
 
-## Learning Objectives
+In this module you will learn to answer the following questions:
+
 - Explain what version control of research software is
 - Illustrate the importance of using version control
 - Identify when in the research cycle to employ version control
 - Compare the use of local and remote version control
 - List the various tools or systems for version control
-- Identify relevant resources for researchers about features commonly used in version control
+- Identify relevant resources for researchers about features commonly used in version control