diff --git a/README.md b/README.md
index 99e0d914..f8febb59 100755
--- a/README.md
+++ b/README.md
@@ -1,10 +1,12 @@
-
+[
](https://github.com/seleniumbase/SeleniumBase/blob/master/README.md)
[
](https://pypi.python.org/pypi/seleniumbase) [
](https://pypi.python.org/pypi/seleniumbase) [
](https://travis-ci.org/seleniumbase/SeleniumBase) [
](https://gitter.im/seleniumbase/SeleniumBase) [
](https://github.com/seleniumbase/SeleniumBase/blob/master/LICENSE) [
](https://github.com/seleniumbase/SeleniumBase/stargazers)
-SeleniumBase transforms [WebDriver](https://www.seleniumhq.org/) into a complete test framework that runs with [Pytest](https://github.com/pytest-dev/pytest).
+###  Automated Testing Made Easy
-##  Quick Start
+SeleniumBase is a complete framework for end-to-end testing and [website walkthroughs](https://github.com/seleniumbase/SeleniumBase/blob/master/examples/tour_examples/ReadMe.md). It uses [WebDriver](https://www.seleniumhq.org/) to control web browsers while using [Pytest](https://github.com/pytest-dev/pytest) for running Python scripts.
+
+##  Quick Start in minutes
(Requires [Python](https://www.python.org/downloads/), [Git](https://git-scm.com/), and an optional [Python virtual environment](https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/virtualenv_instructions.md).)
@@ -52,7 +54,7 @@ pytest google_tour.py
For more detailed steps on getting started, see the [**Detailed Instructions**](#seleniumbase_installation) section.
-###  Learn More:
+##  Learn More:
#### **No more repetitive WebDriver code:**
SeleniumBase automatically handles common WebDriver actions such as spinning up web browsers, waiting for page objects to load, saving screenshots during test failures, using a proxy server, and more. ([Read about customizing test runs](https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/customizing_test_runs.md).)
diff --git a/_config.yml b/_config.yml
index d1c02bd9..ecda4ad9 100644
--- a/_config.yml
+++ b/_config.yml
@@ -1,3 +1,3 @@
theme: jekyll-theme-cayman
title: SeleniumBase
-description: Web Automation & Testing Framework
\ No newline at end of file
+description: Automated Testing Made Easy
\ No newline at end of file
diff --git a/examples/tour_examples/ReadMe.md b/examples/tour_examples/ReadMe.md
index 2891bc94..ef571ab4 100755
--- a/examples/tour_examples/ReadMe.md
+++ b/examples/tour_examples/ReadMe.md
@@ -2,7 +2,7 @@
-SeleniumBase Tours utilize the [Shepherd Library](https://cdnjs.com/libraries/shepherd/1.8.1) for creating and running tours, demos, and walkthroughs on any website.
+SeleniumBase Tours utilize the [Shepherd Javascript Library](https://cdnjs.com/libraries/shepherd/1.8.1) for creating and running tours, demos, and walkthroughs on any website.
To utilize tours, there are three methods that you need to know at the basic level (which contain optional arguments):
@@ -14,7 +14,7 @@ To utilize tours, there are three methods that you need to know at the basic lev
With the ``create_tour()`` method, you can pass a default theme to change the look & feel of the tour steps. Valid themes are ``dark``, ``default``, ``arrows``, ``square``, and ``square-dark``.
-With the ``self.add_tour_step()`` method, at minimum you must pass a message to display. Then you can specify a web element to attach to (by CSS selector). If no element is specified, the tour step will tether to the top of the screen by default. You can also add an optional title above the message to display with the tour step, as well as change the theme for that step, and even specify the alignment (which is the side of the element that you want the tour message to tether to).
+With the ``self.add_tour_step()`` method, you must first pass a message to display. You can then specify a web element to attach to (by using [CSS selectors](https://www.w3schools.com/cssref/css_selectors.asp)). If no element is specified, the tour step will tether to the top of the screen by default. You can also add an optional title above the message to display with the tour step, as well as change the theme for that step, and even specify the alignment (which is the side of the element that you want the tour message to tether to).
Finally, you can play a tour you created by calling the ``self.play_tour()`` method. If you specify an interval, the tour will automatically walk through each step after that many seconds have passed.
@@ -28,22 +28,18 @@ class MyTourClass(BaseCase):
def test_google_tour(self):
self.open('https://google.com')
self.wait_for_element('input[title="Search"]')
+
self.create_tour(theme="dark")
- self.add_tour_step(
- "Click to begin the Google Tour!", title="SeleniumBase Tours")
- self.add_tour_step(
- "Type in your search query here.", 'input[title="Search"]')
- self.add_tour_step(
- "Then click here to search!", 'input[value="Google Search"]',
- alignment="bottom", theme="arrows")
- self.add_tour_step(
- "Or click here to see the top result.",
- '''[value="I'm Feeling Lucky"]''',
+ self.add_tour_step("Click to begin the Google Tour!", title="SeleniumBase Tours")
+ self.add_tour_step("Type in your search query here.", 'input[title="Search"]')
+ self.add_tour_step("Then click here to search!", 'input[value="Google Search"]',
alignment="bottom", theme="arrows")
+ self.add_tour_step("Or click here to see the top result.",
+ '''[value="I'm Feeling Lucky"]''', alignment="bottom", theme="arrows")
self.play_tour()
```
-### This example was taken from [google_tour.py](https://github.com/seleniumbase/SeleniumBase/blob/master/examples/tour_examples/google_tour.py), which you can run with:
+#### This example was taken from [google_tour.py](https://github.com/seleniumbase/SeleniumBase/blob/master/examples/tour_examples/google_tour.py), which you can run from the ``examples/tour_examples`` folder with the following command:
```bash
pytest google_tour.py