Skip to content

Commit

Permalink
Move motivation content to the front page
Browse files Browse the repository at this point in the history
  • Loading branch information
robmoss committed Sep 15, 2023
1 parent 9fa1ec5 commit 40ac233
Show file tree
Hide file tree
Showing 3 changed files with 25 additions and 25 deletions.
26 changes: 25 additions & 1 deletion src/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,9 +4,33 @@ These materials aim to support
early- and mid-career researchers (EMCRs) in the
[SPECTRUM](https://www.spectrum.edu.au/) and [SPARK](https://www.spark.edu.au/) networks to develop their computing skills, and to make effective use of available tools[^tools] and infrastructure[^infra].

## Motivation

```admonish question
Why dedicate time and effort to learning these skills?
There are [many reasons](motivation.md)!
There are **many reasons!**
```

The overall aim of these materials is help you conduct code-driven research **more efficiently** and with **greater confidence**.

Hopefully some of the following reasons resonate with you.

- **Fearlessly modify your code**, knowing that your past work is never lost, by using [version control](./version-control/).

- **Verify that your code behaves as expected**, and get notified when it doesn't, by [writing tests](./testing/).

- **Ensure that your results won't change** when running on a different computer by "baking in" [reproducibility](./reproducibility/).

- **Improve your coding skills**, and those of your colleagues, by working [collaboratively](./collaborating/) and making use of [peer code review](./collaborating/peer-code-review.md).

- **Run your code quickly**, and without relying on your own laptop or computer, by using [high-performance computing](./high-performance-computing/).

```admonish tip title="Foundations of effective research"
A piece of code is often useful beyond a single project or study.
By applying the above skills in your research, you will be able to easily reproduce past results, extend your code to address new questions and problems, and allow others to build on your code in their own research.
The benefits of good comptuational practices can pay off long after the project is finished.
```

## Structure
Expand Down
1 change: 0 additions & 1 deletion src/SUMMARY.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,6 @@
# Summary

[Introduction](README.md)
[Motivation](motivation.md)
[Learning objectives](learning-objectives.md)
[Prerequisites](prerequisites.md)

Expand Down
23 changes: 0 additions & 23 deletions src/motivation.md

This file was deleted.

0 comments on commit 40ac233

Please sign in to comment.