diff --git a/modules/citation/info.md b/modules/citation/info.md index 058f851e..07d3d240 100644 --- a/modules/citation/info.md +++ b/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? diff --git a/modules/documentation/info.md b/modules/documentation/info.md index b4c2d9d1..82f00d43 100644 --- a/modules/documentation/info.md +++ b/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? diff --git a/modules/licenses/info.md b/modules/licenses/info.md index 0929e7f4..a7a83664 100644 --- a/modules/licenses/info.md +++ b/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? diff --git a/modules/publication/info.md b/modules/publication/info.md index ae46a307..c3282ea9 100644 --- a/modules/publication/info.md +++ b/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? diff --git a/modules/researchsoftware/info.md b/modules/researchsoftware/info.md index ad311a3a..1d5b5c35 100644 --- a/modules/researchsoftware/info.md +++ b/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? diff --git a/modules/researchsoftware/slides-researchsoftware.md b/modules/researchsoftware/slides-researchsoftware.md index cb1218eb..8814dd86 100644 --- a/modules/researchsoftware/slides-researchsoftware.md +++ b/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 === diff --git a/modules/researchsoftware/slides-software.md b/modules/researchsoftware/slides-software.md index f7d337e0..bce4c380 100644 --- a/modules/researchsoftware/slides-software.md +++ b/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 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). diff --git a/modules/softwarelandscape/info.md b/modules/softwarelandscape/info.md index b93b683c..1bc35ccf 100644 --- a/modules/softwarelandscape/info.md +++ b/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? \ No newline at end of file +- What initiatives exist to tackle these issues? diff --git a/modules/softwarelandscape/slides.md b/modules/softwarelandscape/slides.md index b03bb1cc..ca584929 100644 --- a/modules/softwarelandscape/slides.md +++ b/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. diff --git a/modules/softwaremanagementplans/info.md b/modules/softwaremanagementplans/info.md index 6020709f..cacc8425 100644 --- a/modules/softwaremanagementplans/info.md +++ b/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? diff --git a/modules/softwaremanagementplans/slides-smp.md b/modules/softwaremanagementplans/slides-smp.md index 3e18f625..c1e7745f 100644 --- a/modules/softwaremanagementplans/slides-smp.md +++ b/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) diff --git a/modules/testing/info.md b/modules/testing/info.md index 80386741..6e9a1b96 100644 --- a/modules/testing/info.md +++ b/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 \ No newline at end of file +- Get familiar with the idea of continuous integration and its importance diff --git a/modules/version-control/info.md b/modules/version-control/info.md index 86b9eb8e..6c7a1aec 100644 --- a/modules/version-control/info.md +++ b/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 \ No newline at end of file +- Identify relevant resources for researchers about features commonly used in version control