Workshop rover

site/viamguides/src/drive-rover-ts/drive-rover-ts.md

@@ -50,6 +50,7 @@ Duration: 2
 
 1. Go to [Try Viam](https://app.viam.com/try) in your web browser to remotely control a rover pre-configured with components in the NYC Viam robotics lab. This may take up to 30 seconds.
    ![Try Viam landing page](assets/tryViam.png)
+
    > aside negative
    > You can also use [your own Viam rover](https://docs.viam.com/appendix/try-viam/rover-resources/) or another wheeled robot.
 
@@ -74,21 +75,22 @@ Duration: 2
 Now that you know how to manually control the rover using the Viam app, let's control the rover programmatically with code.
 
 1. From the command line within your terminal window, let's use a command line utility to quickly set up a new TypeScript project. Input the following command:
-    ```bash
-    $ npm create robot-app
-    ```
+   ```bash
+   $ npm create robot-app
+   ```
 1. At the command-line prompt, input your project name. Or hit **Enter** to accept the default project name, `my-viam-project`.
    ![command line prompt](assets/myViamProject.png)
+1. Select the project template `controlRover`, and hit **Enter**.
 1. Once the project setup is completed, follow the command-line instructions. Navigate into your new project directory. In the example shown below, we are using the default project name `my-viam-project`.
-    ```bash
-    $ cd my-viam-project
-    ```
+   ```bash
+   $ cd my-viam-project
+   ```
 1. In the Viam app, find the **CONNECT** page, select the **TypeScript** SDK, and turn on **Include API key** to reveal your machine credentials within the code sample. Use these machine credentials to update the `.env` file in your new project directory, and save your changes.
    ![machine credentials](assets/viamMachineCredentials.png)
 1. Start the application server. Your web app should be running at `http://localhost:5173/`
-    ```bash
-    $ npm start
-    ```
+   ```bash
+   $ npm start
+   ```
 1. Open your browser's devtools, for example, by right-clicking and selecting **Inspect**, to see the browser's console logs. And position the browser window so you can once again see the `overhead-cam` in the CONTROL tab within the Viam app. Press the **Click me** button in the web application to see the console logs and camera feed of the rover in the robotics lab at the same time.
    ![drive it](assets/driveIt.png)
 1. In your IDE, edit `src/main.ts` to change the logic being run. Edit `index.html` to change the layout of the web application.
@@ -103,9 +105,11 @@ Duration: 2
 > If you want more time to keep playing with your borrowed rover, hit the **Extend** button in the top right of the page.
 
 ### What You Learned
+
 - How to drive a rover in a square using the Viam TypeScript SDK
 - How to use environment variables with your Viam machine
 
 ### Related Resources
+
 - [Detect people with a webcam](https://docs.viam.com/get-started/detect-people/): use the borrowed rover's webcam or the webcam on your own laptop to deploy and use a machine learning model with a vision service
 - Explore other [Viam SDK libraries](https://docs.viam.com/sdks/), besides TypeScript for backend, frontend, and mobile development.

site/viamguides/src/workshop-air-monitoring/workshop-air-monitoring.md

@@ -103,7 +103,8 @@ Review these setup steps as you're planning the workshop to help prepare for it.
    - **Verify equipment inventory:** Decide which materials are provided or required for participants to bring on their own. Order any materials and supplies that are provided to participants.
    - **Confirm workstation setup**: Verify the workshop room layout supports hardware work, such as tables. Ensure participants have power outlets and internet access. Have spare supplies, such as Raspberry Pis, sensors, and cables, in case of failures. For virtual workshops, confirm logistics for breakout sessions, providing support, and checkpoints.
    - **Communicate prerequisites**: Share a participant guide prior to the workshop with learning objectives and instructions for installing software and preparing laptops. Provide a checklist for participants to confirm readiness.
-   - **Establish support channels**: determine how participants can get support for real-time troubleshooting (e.g. Slack or Discord channel for virtual workshops, additional helpers in the room for on-site workshops)
+   - **Establish support channels**: Determine how participants can get support for real-time troubleshooting (e.g. Slack or Discord channel for virtual workshops, additional helpers in the room for on-site workshops)
+   - **Request Viam stickers**: Don't forget [to request Viam stickers](https://forms.gle/TFXBm7L9n8U4hLRj9) for the workshop.
 1. **Content Preparation**
    - **Prepare workshop teaching materials**: Review the Delivery Plan, sample slide deck, and provided resources. Tailor these materials to suit your participants' needs. Decide whether to present them to the group or provide them for independent reference, such as through a web browser or printed handouts.
    - **Prepare code and documentation**: Review the provided code and add comments as necessary.
@@ -513,14 +514,16 @@ Duration: 5
 
 ### Additional resources
 
-- The website [pinout.xyz](https://pinout.xyz/) is a helpful resource with the exact layout and role of each pin for Raspberry Pi.
+- The website [pinout.xyz](https://pinout.xyz/) is a helpful resource with the exact layout and role of each pin for Raspberry Pi. When working with Viam, make sure to reference the physical pin numbers, and not the GPIO numbers listed on `pinout.xyz`.
 - The U.S. Environmental Protection Agency provides [basics on particulate matter (PM)](https://www.epa.gov/pm-pollution/particulate-matter-pm-basics). For measuring the [indoor air quality](https://www.epa.gov/indoor-air-quality-iaq/indoor-pollutants-and-sources) in your home, we'll be looking at PM2.5, a very small particle size.
 - The [demo video](https://youtu.be/TZJSAncrU4o?feature=shared) provides a brief overview of the project.
 
 <img src="assets/service.png" alt="service icon" width="200">
 
 ### Common pitfalls and troubleshooting guidance
 
+1. **Security**
+   - Do not share your API credentials publicly. Sharing this information could compromise your system security by allowing unauthorized access to your machine, or to the computer running your machine.
 1. **Flashing firmware**
    - Make sure you are using a 5V 5A (25W) power supply. USB boot is disabled by default [when connected to a 3A power supply](https://www.raspberrypi.com/documentation/computers/raspberry-pi.html#differences-on-raspberry-pi-5), so adequate amperage is required for the optimal performance of your Raspberry Pi 5.
    - Participants must remember the `hostname` and `username` they set while flashing their Raspberry Pi, as they will need this when they SSH into the Pi.
@@ -533,6 +536,20 @@ Duration: 5
    - If any problems occur while setting up the machine and peripherals in [the Viam app](https://app.viam.com), check under the **LOGS** tab to see what might be going wrong.
    - Also refer to the overall [Viam troubleshooting guide](https://docs.viam.com/appendix/troubleshooting/).
 
+<img src="assets/viam-rasp.png" alt="raspberry pi icon" width="200">
+
+### Logistics for continued learning
+
+Participants have several options for continuing their projects beyond the workshop environment:
+
+- **Take-home projects**: For participants allowed to take their projects home after the workshop, the `viam-agent` on the Raspberry Pi can simplify the setup process:
+
+  - **Provisioning mode**: Upon rebooting the Raspberry Pi in a new environment like at home, the `viam-agent` automatically creates a Wi-Fi hotspot if it cannot connect to a known network.
+  - **Connect to the hotspot**: Look for a network named `viam-setup-HOSTNAME` in your list of available Wi-Fi networks, where `HOSTNAME` is the custom hostname you set during the workshop, and `viamsetup` is the default password. Connect your laptop to this network.
+  - **Provide network information for the machine**: Go to the provisioning portal at `http://viam.setup/` in a browser to follow [the on-screen instructions](https://docs.viam.com/fleet/provision/#end-user-experience) to configure the Raspberry Pi for your home Wi-Fi.
+
+- **Remote control**: If participants are not allowed to take their projects home after the workshop, but want to continue working on their projects from home, they can access the Raspberry Pi remotely from anywhere in the world and continue accessing sensor data. If participants do not have SSH access into the Raspberry Pi, participants can write and run code on their laptops from home.
+
 <!-- ------------------------ -->
 
 ## Post-Workshop Resources
@@ -577,6 +594,8 @@ Here are some ideas for expanding and enhancing the current project.
 - [Visualize sensor data with Grafana Cloud](https://codelabs.viam.com/guide/grafana/index.html?index=..%2F..index#0) codelab
 - [Monitor Air Quality with a Fleet of Sensors](https://docs.viam.com/tutorials/control/air-quality-fleet/) tutorial
 
+<img src="assets/logistics.png" alt="viam icons" width="200">
+
 ### Post-workshop resources for participants
 
 - [Viam documentation](https://docs.viam.com/) for reference