Merge branch '1-getting-started' into 2-first-steps

Author: AutomationPanda

README.md

@@ -1,12 +1,20 @@
 # tau-playwright-workshop
 
-This repository contains the example code for the Playwright workshop
+This repository contains the instructions and example code for the Playwright workshop
 for [TAU: The Homecoming](https://applitools.com/tau-homecoming/)
 on December 1, 2021.
 The workshop will be done in [Python](python.org).
 
-The `workshop` folder contains full instructions for the workshop.
-That way, you can still code along to learn Playwright even if you miss the main event!
+
+## Instructions
+
+Please try to attend the workshop *live* on the day of the event.
+However, if you cannot make it, never fear!
+**You can still take the workshop as a self-guided tutorial.**
+Start by reading this README.
+Then, follow the guides in the `workshop` folder.
+Each part of the workshop has a `workshop` guide with full instructions.
+Feel free to open issues against this repository if you have any trouble completing the workshop independently.
 
 
 ## Abstract
@@ -41,7 +49,7 @@ If you are using a different shell or a Windows command line, some commands may
 
 ## Agenda
 
-This workshop has five main parts:
+This workshop has five main parts, each with three sections:
 
 1. Getting started
    1. What is Playwright?
@@ -67,7 +75,7 @@ This workshop has five main parts:
 
 ## Example code branches
 
-Each part has a corresponding branch in this repository containing the part's example code and `workshop` instructions.
+Each workshop part has a corresponding branch in this repository containing the part's example code and `workshop` instructions.
 The branches allow you to check your progress at any point during the workshop.
 The branch names are:
 

workshop/1-getting-started.md

@@ -1,6 +1,6 @@
 # Part 1: Getting started
 
-Part 1 of the workshop explains how to start testing with Playwright and pytest in Python.
+Part 1 of the workshop explains how to set up a Python test automation project with pytest and Playwright.
 
 
 ## What is Playwright?
@@ -62,13 +62,10 @@ to manage dependency packages locally:
 
 ```bash
 $ python3 -m venv venv
-$ source venv/bin/activate
 ```
 
 Creating a new virtual environment for each Python project is a recommended practice.
 This command will create a subdirectory named `venv` that holds all virtual environment files, including dependency packages.
-After creating a virtual environment, you must "activate" it to use it using the `source` command shown above.
-You can tell if a virtual environment is active if its name appears in the bash prompt.
 
 *A note about Python commands:*
 Python has two incompatible major versions: 2 and 3.
@@ -77,6 +74,21 @@ For example, macOS comes bundled with Python 2.7.18.
 Sometimes, the `python` executable may point to Python 2 instead of 3.
 To be precise about versions and executables, we will use the `python3` and `pip3` commands explicitly in this workshop.
 
+After creating a virtual environment, you must "activate" it.
+On macOS or Linux, use the following command:
+
+```bash
+$ source venv/bin/activate
+```
+
+The equivalent command for a Windows command line is:
+
+```
+> venv\Scripts\activate.bat
+```
+
+You can tell if a virtual environment is active if its name appears in the prompt.
+
 Let's add some Python packages to our new virtual environment:
 
 ```bash