annotated notes

brownsarahm · brownsarahm · commit 28586d82f87b · 2023-01-26T19:45:34.000-05:00
diff --git a/notes/2023-01-26.md b/notes/2023-01-26.md
@@ -86,85 +86,43 @@ If you missed class, create a [project](https://docs.github.com/en/issues/planni
 In your repository, edit the: `/.github/workflows/getassignment.yml` file to remove either the two lines about practice or the two lines about review since you can only earn one or the other of these two types of badge per date. 
 
 
-Edit the file `/.github/workflows/track.yml` to be like this example: 
-
-```yml
-name: Add planned badges to grade tracker (edits required)
-#  remove the () when you edit
-
-on:
-  issues:
-    types:
-      - opened
-
-jobs:
-  add-to-project:
-    name: Add planned based badge to grade tracker
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/add-to-project@RELEASE_VERSION
-        with:
-          # add your project board's number, replaceing the <projectNumber>
-          project-url: https://github.com/orgs/introcompsys/projects/<projectNumber>
-          github-token: ${{ secrets.ADD_TO_PROJECT_PAT }}
-          labeled: experience, practice, prepare, review,
-          label-operator: OR
+```{warning}
+This is different from in class
 ```
 
-
-## What does it mean to study Computer Systems?
+delete the  `/.github/workflows/track.yml`  file, we will add items to the project a different way. 
 
 
 
 
+## What does it mean to study Computer Systems?
 
 
 
 _"Systems"_ in computing often refers to all the parts that help make the
 "more exciting" algorithmic parts work. Systems is like the magic that helps
 you get things done in practice, so that you can shift your attention elsewhere.
-
-
-
 In intro courses, we typically give you an environment to hide all the problems
 that could occur at the systems level.
 
 
+```{important}
+In this course, we will take the time to understand all of this stuff. This means that we will use a different set of strategies to study it than we normally see in computer science.
+```
 
-Systems programming is how to look at the file system, the operating system, etc.
 
 
+_Systems programming_ is how to look at the file system, the operating system, etc.
 
-From ACM Transactionson Computer Systems
 
 
+From ACM Transactions on Computer Systems
 
 > ACM Transactions on Computer Systems (TOCS) presents research and development results on the design, specification, realization, behavior, and use of computer systems. The term "computer systems" is interpreted broadly and includes systems architectures, operating systems, distributed systems, and computer networks. Articles that appear in TOCS will tend either to present new techniques and concepts or to report on experiences and experiments with actual systems. Insights useful to system designers, builders, and users will be emphasized.
 
 
-
-"Systems" in computing often refers to all the parts that help make the
-"more exciting" algorithmic parts work. Systems is like the magic that helps
-you get things done in practice, so that you can shift your attention elsewhere.
-
-
-
-In intro courses, we typically give you an environment to hide all the problems
-that could occur at the systems level.
-
-
-
-
-```{important}
-In this course, we will take the time to understand all of this stuff. This means that we will use a different set of strategies to study it than we normally see in computer science.
-```
-
-
-
 We are going to be studying aspects *of* computer systems, but to really understand them, we also have to think about how and why they are the way they are.  We will therefore study in a broad way.  
 
-
-
 We will look at blogs, surveys of developers, and actually examine the systems themselves.
 
 
@@ -174,7 +132,7 @@ We will look at blogs, surveys of developers, and actually examine the systems t
 
 
 
-> ### What is it like to know something really well?
+ ### What is it like to know something really well?
 > When we know something well, it is easier to do, we can do it multple ways,
 > it is easy to explain to others and we can explain it multiple ways.
 > we can do the task almost automatically and combine and create things in new
@@ -191,74 +149,14 @@ Novices have sparse mental models, experts have connected mental models.
 
 
 
-We can visualize with concept maps.
-
-
-
-
-When we first learn new things, we first get the basic concepts down, but we
-may not know how they relate.
-
-
-
-```{figure} ../img/2022-01-27-mental_model_novice.svg
-
-
-
-a novice mental model is disconnected and has few concepts
-```
-
-
-
-As we learn more, they become more connected.
-
-
-
-```{figure} ../img/2022-01-27-mental_model_competent.svg
-
-
-
-a compententmental model starts to have some connections, with relationships
-between the concepts.
-```
-
-
-
-
-```{figure} ../img/2022-01-27-mental_model_advanced.svg
-
-
-
-an expert mentla model is densley connected and has more concepts in it.
-```
-
-
-
-We can visualize with concept maps. Which connect the ideas using relationships
-on the arrows.
-
-
-
-```{figure} ../img/2022-01-27-mental_model_git.svg
-
-
-
-a small concept map showing that git is an instance of both a file system and
-a version control system.
-```
+<!-- We can visualize with concept maps. -->
 
 
 
 ## Why do we need this for computer systems?
 
 
 
-```{attention}
-This section contain points added here that were not discussed directly in class, but are important and will come back up
-```
-
-
-
 ### Systems are designed by programmers
 
 
@@ -299,11 +197,9 @@ they think. So, while you do **not** have to think the same way as these pattern
 knowing what they are will help you reading code, and understanding things.  
 
 
-
-
-
-
-
+```{important}
+Some of this was not discussed in class
+```
 
 ```{figure} https://drek4537l1klr.cloudfront.net/hermans2/Figures/CH01_F02_Hermans2.png
 
@@ -342,67 +238,52 @@ to read.
 We will see how the best choice varies a lot as we investigate things at
 different levels of abstraction.
 
+## Admin 
 
-
-
-
-## Prepare for this class 
-
-```{include} ../_soln_prepare/01-logistics.md
-```
-
-## Review today's class
-
-```{include} ../_soln_review/01-logistics.md
+```{warning}
+I created your issues for you, but GitHub's server is in a different time zone so the issue titles have the wrong date.  You can change it, or not, your choice
 ```
 
+Remember you can create branches to work on each badge [from the issue](https://docs.github.com/en/issues/tracking-your-work-with-issues/creating-a-branch-for-an-issue)
 
 
-## More Practice
+## Review today's class
 
-```{include} ../_soln_practice/01-logistics.md
+```{include} ../_review/2023-01-26.md
 ```
 
 
 
-## Prepare for this class 
-
-```{include} ../_soln_prepare/01-logistics.md
-```
-
-## Review today's class
+## Prepare for Next Class
 
-```{include} ../_soln_review/01-logistics.md
+```{include} ../_prepare/2023-01-26.md
 ```
 
 
 
 ## More Practice
 
-```{include} ../_soln_practice/01-logistics.md
-```
-
-## Review today's class
-
-```{include} ../_review/2023-01-26.md
+```{include} ../_practice/2023-01-26.md
 ```
 
 
 
-## Prepare for Next Class
-
-```{include} ../_prepare/2023-01-26.md
-```
-
+## Experience Report Evidence
 
+If you missed class today, there is no separate evidence beyond updates to your repo. 
 
-## More Practice
+## Questions After Today's Class 
 
-```{include} ../_practice/2023-01-26.md
+```{important}
+Comming soon! 
 ```
 
+```{admonition} Make an issue or PR 
+:class: community 
 
+Add your question directly to the course website as an issue or a PR. 
 
-## Experience Report Evidence
+ To make a PR, use the "suggest edit" button behind the {fa}`github` icon at the top.  It will have you make a fork which is a copy of the repo that lives on your own account instead of the organization and then you can submit a PR> 
 
-## Questions After Today's Class 
+ Doing this will not always be worth a community badge, but I hit a challenge in the way I had planned to, so I'm giving you an extra opportunity. 
+ ```
diff --git a/syllabus/tools.md b/syllabus/tools.md
@@ -61,6 +61,10 @@ as the [Authentication rules](https://docs.github.com/en/github/authenticating-t
 You will also need the [gh CLI](https://cli.github.com/). It will help with authentication
 and allow you to work with other parts of github besides the core git operations. 
 
+```{important}
+You need to install this on Mac
+```
+
 <!-- In order to use the command line 
 with https, you will need to [create a Personal Access Token](https://docs.github.com/en/github/authenticating-to-github/creating-a-personal-access-token) for each device you use. In order to use the command line 
 with SSH, set up your public key. -->
