tech mentor links, misc changes

Author: rkdarst

content/ethics.rst

@@ -2,11 +2,15 @@ Ethics
 ======
 
 * Ethics of science
-    * Reproducibility
-    * Academic credit
+
+  * Reproducibility
+  * Academic credit
+
 * Personal data
-    * Definitions
-    * Legal bases of handling
-    * Required steps
-    * How Aalto process works
+
+  * Definitions
+  * Legal bases of handling
+  * Required steps
+  * How Aalto process works
+
 * AI ethics

content/it-in-aalto.rst

@@ -5,13 +5,15 @@ IT in Aalto
 * Data storage
 * Compute services
 * Department IT
-    * Who is there
-    * Services
-    * CSIT
-    * PHYS IT
-    * 
+
+  * Who is there
+  * Services
+  * CSIT
+  * PHYS IT
+  * 
+
 * CSC
-    * HPC
-    * Data services
-    * Server computing services
-    * Teaching
+  * HPC
+  * Data services
+  * Server computing services
+  * Teaching

content/roles/garage.rst

@@ -68,7 +68,7 @@ Expectations / checklists
 External materials
 ------------------
 * `How to help someone use a computer
-  <https://www.librarian.net/stax/4965/how-to-help-someone-use-a-computer-by-phil-agre/>`
+  <https://www.librarian.net/stax/4965/how-to-help-someone-use-a-computer-by-phil-agre/>`__
   by Phil Agre
 * `How to ask for help with supercomputers
   <https://cicero.xyz/v3/remark/0.14.0/github.com/bast/help-with-supercomputers/main/talk.md/#1>`__

content/roles/technical-mentor.rst

@@ -28,6 +28,9 @@ Expectations / checklists
 External materials
 ------------------
 
+* `How to help someone use a computer
+  <https://www.librarian.net/stax/4965/how-to-help-someone-use-a-computer-by-phil-agre/>`__
+  by Phil Agre
 * `Video: support services vs diversity <https://www.youtube.com/watch?v=z1VS1wleN-o>`__.
 
 

content/security.rst

@@ -2,9 +2,13 @@ Security
 ========
 
 * Basics
+
   * Don't share accounts, know your data rating, handle it correctly
+
 * Know basics
+
   * Decide security level needed for data.  Don't over classify
   * Select right systems for this
   *
+
 * Common working practices

content/tech.rst

@@ -63,8 +63,12 @@ There are a few other interesting CodeRefinery lessons: https://coderefinery.org
 HPC
 ---
 
-* Triton tutorials is what we expect our users to know, and reading through these is enough (it will be familiar): https://scicomp.aalto.fi/triton/#tutorials
-* And in general, browse (but not read in detail) the rest of the Triton  https://scicomp.aalto.fi/triton/
+
+* Triton tutorials is what we expect our users to know, and reading
+  through these is enough (it will be familiar):
+  https://scicomp.aalto.fi/triton/#tutorials
+* And in general, browse (but not read in detail) the rest of the
+  Triton https://scicomp.aalto.fi/triton/
 
 
 Programming
@@ -74,13 +78,19 @@ Python
 ~~~~~~
 
 * Python virtual environments and Conda environments: https://scicomp.aalto.fi/scicomp/python/ , https://scicomp.aalto.fi/triton/apps/python/
+
   * Be able to create a virtual environment
+
 * Python module/package structure
 * Python packaging
+
   * https://packaging.python.org/en/latest/tutorials/packaging-projects/
   * setup.py vs pyproject.toml (newer)
-* Python command line interfaces (argparse), installing interfaces via packages, ...
+
+* Python command line interfaces (argparse), installing interfaces via
+  packages, ...
 * Other steps for a good project
+
   * Good project structure (module-name/module_name/)
   * Command line interface
   * Modular and maintainable code