Merge pull request #53 from code4policy/master_sync

Merge the synced master_sync to main

agile/03-user-stories.md

@@ -1,6 +1,6 @@
 ## A Scrum-ified (Scrum-ish?) J-term
 
-[Aggregate responses](https://docs.google.com/forms/d/1Vh3nJAqUptMGIT2dP9JnKpkORG-5r3FM0LcXAigH9qA/edit#responses)
+[Aggregate responses](https://docs.google.com/forms/d/e/1FAIpQLScC3p3cNDHRRoWkE9lH2kT6XNAaY_uiILmq2dPFKiplR1KnUQ/viewform?usp=sharing)
 * Do you think that you will use code or data analysis in your future work?
 
 ## User Research

agile/06-reading.md

@@ -2,15 +2,23 @@
 
 ## Assignment
 
-1. Read the recommended reading
+1. Read the required reading
 2. Start discussing what you just read in Slack. There is an #agile channel where you can discuss. Note down any burning questions you might have about the reading.
 
-## Recommended Reading
-- [Scrum: The Art of Doing Twice the Work in Half the Time](https://www.amazon.com/Scrum-Doing-Twice-Work-Half/dp/038534645X) [Chapter 1] (provided on canvas)
+## Required Reading
+
+**Due Tomorrow**
+
+- [Scrum: The Art of Doing Twice the Work in Half the Time](https://www.amazon.com/Scrum-Doing-Twice-Work-Half/dp/038534645X) [Chapter 1] (provided on Slack)
 - [Elements of Scrum](https://www.amazon.com/Elements-Scrum-Chris-Sims-ebook/dp/B004O0U74Q/ref=sr_1_2?s=digital-text&ie=UTF8&qid=1546492282&sr=1-2&keywords=elements+of+scrum) [Part I and Part II] 
 	- (Go ahead and read the whole thing if you find yourself interested, its not too long)
 
-A shorter alternative to "Elements of Scrum"
+**Due Friday**
+ - Healthcare.gov Case Part A (provided on Slack) - Read by Friday
+
+## Additional Resources
+
+A shorter alternative to "Elements of Scrum" (in case you run out of time)
 
 - [Scrum: A Breathtakingly Breif and Agile Introduction](https://www.amazon.com/dp/B007P5N8D4/ref=dp-kindle-redirect?_encoding=UTF8&btkr=1)
 	- This book essentially repeats the concepts from Elements of Scrum. It would be handy to have a copy of it as a guide for the class. If don't have time to read Elements of Scrum, please at least flip through this book (it's much shorter).

commandline/01-intro.md

@@ -160,7 +160,8 @@ Now that you have an understanding of option/flags vs. positional arguments, let
 * **clear**s all output from your console
 * on macOS, you can also press `Ctrl+L` to clear your console while retaining history or `Cmd-K` to clear console while deleting the history. `Ctrl+L` should work on Ubuntu as well.
 
-### ❇️ Example
+
+### :large_orange_diamond: Example
 
 1. print your username to the command line using `whoami`
 2. print your computer's name to the command line using `hostname`
@@ -195,9 +196,11 @@ for a given command, its usually either
 ### also, know when to reach out to someone...
 don't go down rabbit holes trying to figure something out if there is someone who knows better nearby and you've already tried the three things above, they might be able to save you a lot of stress. I'm always happy to help out.
 
-## ➡️ Try It
 
-Let's see if you can learn how to use a new command! Experiment working with `cowsay` in the command line by completing the following assignment: https://classroom.github.com/a/eRQxDO0D
+## :white_check_mark: Try It
+
+Let's see if you can learn how to use a new command! Experiment working with `cowsay` in the command line by completing the following assignment: https://classroom.github.com/a/4yAnW2NV
+
 
 ## Dangers
 

commandline/02-filesystem.md

@@ -54,7 +54,8 @@ In the example above, if I was in the Downloads folder and I wanted the relative
 
 In the same example above, the absolute path to the Documents folder would be `/Users/mehtad/Documents`.
 
-#### 🔶 Pop Quiz
+
+#### :raised_hand: Pop Quiz
 
 If you are in the Downloads folder, what folder is:
 
@@ -149,7 +150,8 @@ If you don't have Sublime Text installed, run `brew cask install sublime-text` o
 * `wc -w <path>` only counts words. A "word" is defined as any set of characters delimited by a space.
 * `wc -c <path>` only counts characters
 
-### ➡️ Try It
+
+### :white_check_mark: Try It
 
 1. Take some time to cd around and explore your filesystem. See what is at the root, see if you can find some of the files you use daily.
 2. Navigate to `~/Desktop` and run both `ls -a` and `tree` 
@@ -184,10 +186,9 @@ The command line not only lets you navigate the file system but also manipulate
 * `mv <filename> <new path>` **m**o**v**es a file from its current location to `<new path>`
 * `mv <filename> <new filename>` renames a file without changing its location
 
-### ➡️ Try It
-
-Complete the following assignment: https://classroom.github.com/a/8aL2J4bC
+### :white_check_mark: Try It
 
+Complete the following assignment: https://classroom.github.com/a/d4WK4RbX
 
 ### Finding Files and Folders
 
@@ -209,7 +210,7 @@ Complete the following assignment: https://classroom.github.com/a/8aL2J4bC
     * Hit `Ctrl + c` if you want to cancel the search.
 * Much more complex string-matching patterns can be used (which we will cover in a future class).
 
-### ❇️ Example
+### :large_orange_diamond: Example
 
 `find` all items in the `universe` folder with the `.txt` extension.
 
@@ -218,7 +219,7 @@ cd ~/Development/universe
 find . -name "*.txt"
 ```
 
-### ➡️ Try It
+### :white_check_mark: Try It
 
 `find` all **folders** in the `universe` folder. use `man find` to figure out how to get folders only.
 

finalproject/brainstorm.md

@@ -16,11 +16,13 @@ To visualize the data you've selected, we'll be using [Data Driven Documents in
 
 You can find example D3 visualizations at the following places, but I'd also encourage you to google around. They're all over the internet!
 
-- http://bl.ocks.org/mbostock (Mike Bostock created D3JS, these are his examples)
-- http://bl.ocks.org/ (same website, examples by different people)
 - https://d3js.org/
+- https://observablehq.com/@d3/gallery
 - http://christopheviau.com/d3list/gallery.html
 - https://github.com/d3/d3/wiki/Gallery
+<!-- - http://bl.ocks.org/mbostock (Mike Bostock created D3JS, these are his examples)
+- http://bl.ocks.org/ (same website, examples by different people)
+ -->
 
 In this course you will be asked to create your own D3 visualization, but with the help of ChatGPT! We will use example visualizations, and learn enough code to tweak it to suit the needs of your dataset. You will also manipulate the data in your dataset to fit the format that the visualization requires.
 
@@ -94,11 +96,9 @@ B1: Internet Access Gender Gap | https://code4policy.github.io/code4policy-b1_in
 B2: Twitter Usage of World Leaders | https://whotweetswhat.works/
 B3: Carbon Emmissions | https://code4policy.github.io/Final_Project_Carbon_emission/
 B4: North Korea Missiles | https://eklung05.github.io/Missile-Visualization/
- 
+
 ## Assignment
 
 Do some exploration and fill out this form:
-
 https://docs.google.com/forms/d/e/1FAIpQLSdl75yAkoRPH604lO6ADuVZDw1iscTMgPn_lbIWs1qM-vAfiA/viewform?usp=pp_url&entry.155702682=2023
-
 Leave a note in #section_a or #section_b slack channel with an idea for a dataset and/or visualization that you have researched. 

setup/windows.md

@@ -10,25 +10,19 @@
    - Pin Sublime Text to taskbar.
    - Disable Hot Exit by clicking on Preferences, then Settings. On the right-side pane, enter "hot-exit": "disabled" inside brackets. 
 
-3. Install [Windows Subsystem for Linux (WSL 1)](https://docs.microsoft.com/en-us/windows/wsl/install-win10#manual-installation-steps).
+3. Install [Windows Subsystem for Linux (WSL 2)](https://docs.microsoft.com/en-us/windows/wsl/install-win10#manual-installation-steps).
 
-   - In administrator powershell or cmd prompt, type `wsl --install` then make sure to revert to WSL1 with `wsl --set-default-version 1` since it installs WSL2 by default
-   - If you do not have Windows 10 v1903 or later, you can try the [manual installation](https://docs.microsoft.com/en-us/windows/wsl/install-manual) (steps 1 and 6), but this      has not been tested by course staff
-
-4. Restart.
-
-5. Install [Ubuntu](https://www.microsoft.com/store/apps/9nblggh4msv6) from the Microsoft Store.
+4. Install [Ubuntu](https://www.microsoft.com/store/apps/9nblggh4msv6) from the Microsoft Store.
 
    - Setup user/pass (launch Ubuntu to do this)
    - Create shortcut to WSL home folder on desktop (if you type 'explorer.exe .' a folder should open)   
 
-6. Install [Windows Terminal](https://aka.ms/terminal) from the Microsoft Store.
+5. Install [Windows Terminal](https://aka.ms/terminal) from the Microsoft Store.
 
    - Pin Windows Terminal to taskbar.
-   - Change `defaultProfile` to WSL (ie: Ubuntu).
-   - Set starting directory by clicking on the downward arrow in the top pane, then Defaults under Profiles on the right-hand pane, and set Starting directory to `"\\wsl$\\Ubuntu\\home\\[USERNAME]"`.
-
-7. Install [wsl-open](https://github.com/4U6U57/wsl-open).
+   - Change `defaultProfile` to WSL.
+
+6. Install [wsl-open](https://github.com/4U6U57/wsl-open), by running the following in your terminal
 
    ```
    # Make a bin folder in your home directory
@@ -44,7 +38,7 @@
    chmod +x ~/bin/open
    ```
 
-8. Install [`wsl-subl`](https://github.com/AlJohri/wsl-subl).
+7. Install [`wsl-subl`](https://github.com/AlJohri/wsl-subl).
 
    ```
    # Download the script to a file named 'wsl-subl'
@@ -54,4 +48,4 @@
    chmod +x ~/bin/subl
    ```
 
-9. Go through the instructions at [shell.md](./shell.md).
+8. Go through the instructions at [shell.md](./shell.md).

web/01-web.md

@@ -17,7 +17,7 @@ The term "server" can sometimes be used ambiguously, it can refer the **software
 ![](https://mdn.mozillademos.org/files/8659/web-server.svg)
 Source: [Mozilla Developer Network](https://developer.mozilla.org/en-US/docs/Learn/Common_questions/What_is_a_web_server)
 
-#### ❇️ Example
+#### :large_orange_diamond: Example
 
 Setting up a local server:
 
@@ -34,7 +34,7 @@ Navigate to `http://localhost:8000/` in your web browser
 * `0.0.0.0` will also work. It means something slightly different, but we won't get into that. If you want to know, do some googling! There are some decent explanations on stackoverflow.
 
 
-#### ❇️ Example
+#### :large_orange_diamond: Example
 
 Part of the beauty of the web is that any node can be a server. You don't need special hardware. Your computer, your watch, your raspberry pi, your fridge - with the right programming, any one of them can be a server. I will temporarily open the website that python is serving to `localhost` from my computer to the internet securely using a program called [localtunnel](https://github.com/localtunnel/localtunnel).
 
@@ -51,7 +51,7 @@ Notice the example above navigates to the IP address `0.0.0.0` and port `8000`.
 
 Here is a [list of common port numbers](https://en.wikipedia.org/wiki/Port_(computer_networking)#Common_port_numbers), it would be best to avoid serving a website through any of these.
 
-#### ❇️ Example
+#### :large_orange_diamond: Example
 
 Get the IP address for a website.
 
@@ -95,7 +95,6 @@ Web frameworks are often used to organize code on a dynamic server. Some example
 
 * **Javascript**: React, Angular, Backbone, Ember ...
 
-#### ❇️ Example
-
+#### :large_orange_diamond: Example
  * Polls Frontend [1](https://projects.fivethirtyeight.com/trump-approval-ratings/) [2](https://projects.fivethirtyeight.com/congress-generic-ballot-polls/) (HTML, CSS, JavaScript)
  * Polls Backend [URL Redacted] \(Ruby on Rails\)

web/05-visualization.md

@@ -17,7 +17,7 @@ What D3 is Not
 
 ## Inserting D3 into a webpage
 
-https://classroom.github.com/a/lThE3TSA
+https://classroom.github.com/a/_gB7y5As
 
 ## Project Note