Setup improvements.

Author: adetaylor

docs/exercise1b.md

@@ -6,7 +6,9 @@
   * _Italic_ text
   * Hyperlinks
 * Open up the browser source code (open the file `src/browser/browser.py`) -
-  it's recommended to use Visual Studio Code
+  it's recommended to use Visual Studio Code. (Specifically, if you're using a Chromebook,
+  choose File -> Open Folder, click browser-learning once, and click Open. You can then use
+  the side panel to navigate to `src/browser/browser.py`)
 * Find where it handles these tags. See which is missing.
 
 ## About reading code
@@ -23,6 +25,10 @@ Clues below! But get reading the code first, then come back to this.
 
 ## What's  up with...
 
+### The editor
+
+Top tip for reading code: make the window as big as possible.
+
 ### The overall structure
 
 The program itself is near the bottom of the file. One of the first things

docs/exercise1c.md

@@ -25,7 +25,7 @@ Then use the browser to visit (exactly):
 > You need to run the browser and the server at the same time. The best way to
 > do this is to type Control-Z, and then type `bg`, which will run the browser
 > in the background. (You can see this by typing `jobs`.) Another way is to
-> open another terminal and then run `. venv/bin/activate`.
+> open another terminal and then run `cd browser-learning` then `. venv/bin/activate`.
 
 Ensure you can see bold text and hyperlinks.
 

docs/setup.md

@@ -18,16 +18,17 @@ python3 -m pip install -r src/requirements.txt
 ## Chromebooks
 
 1. Under the main menu in bottom left corner of the screen, open Terminal. Follow the instructions to turn on the Linux environment if necessary. Go with all the standard settings. (Note that this environment may not be available for guest users)
-2. Fetch the zip of this course (the instructor will tell you how). Copy it into the Linux environment from Chrome's downloads page.
-3. In the terminal, run these commands: (you might need to slightly change the filename in the first command)
+2. In the terminal, run these commands:
 ```
-unzip browser-learning.zip
+git clone https://github.com/adetaylor/browser-learning.git
 cd browser-learning
 ./install-chromebook-prerequisites.sh
 python3 -m venv venv
 . venv/bin/activate
-python3 -m pip install -r src/requirements.txt
+pip3 install -r src/requirements.txt
 ```
+3. Keep the terminal open - you'll need it to run commands. (If you open a new terminal, run `cd browser-learning` and then `. venv/bin/activate`)
+4. From the main menu, also open Visual Studio code.
 
 ## Other types of machine
 

install-chromebook-prerequisites.sh

@@ -3,4 +3,5 @@
 curl -o code.deb -L http://go.microsoft.com/fwlink/?LinkID=760868
 sudo dpkg -i code.deb
 sudo apt-get update
+sudo apt --fix-broken install
 sudo apt-get install python3.11-venv python3.11-tk pip openssl tcpdump libnss3 libnspr4