README.md

@@ -6,7 +6,7 @@
 
 It is designed to allow new learners to quickly and easily create GUIs for their programs.
 
-![Have a go with guizero and see what you can create](docs-src/docs/images/have-a-go.png)
+![Have a go with guizero and see what you can create](docs/images/have-a-go.png)
 
 ```python
 from guizero import App, Text, PushButton

docs/deployment.md

@@ -37,7 +37,7 @@ twine upload dist/* --skip-existing
 Build:
 
 ```
-cd guizero/docs
+cd guizero
 mkdocs build
 ```
 

docs/window.md

@@ -112,7 +112,7 @@ Create an `Window` object by calling the `Window()` constructor. You should give
 ```python
 from guizero import App, Window
 app = App(title="My app", height=300, width=200)
-window = Window(app, title = "2nd Window", height=300, width=200)
+window = Window(app, title="A new Window", height=300, width=200)
 app.display()
 ```
 
@@ -124,13 +124,13 @@ app.display()
 from guizero import App, Window, PushButton
 
 def open_window():
-    window_2.show()
+    window.show()
 
 app = App(title="My app", height=300, width=200)
-window = Window(app, title = "2nd Window", height=300, width=200)
-window.hide()
+button = PushButton(app, text="Show second window", command=open_window)
 
-open_button(app, text="open 2nd window", command=open_window)
+window = Window(app, title="A new Window", height=300, width=200)
+window.hide()
 
 app.display()
 ```
@@ -139,5 +139,5 @@ If you want a `Window` to become the main window and stop all other windows resp
 
 ```python
 def open_window():
-    window_2.show(wait = True)
+    window.show(wait=True)
 ```

mkdocs.yml

@@ -0,0 +1,46 @@
+site_name: guizero
+theme:
+  name: 'litera'
+extra_css: [extra.css]
+nav:
+  - About: about.md
+  - Installation: index.md
+  - Using guizero:
+      - Getting started: start.md
+      - Using Widgets: usingwidgets.md
+      - Commands: commands.md
+      - Multiple windows: multiple_windows.md
+      - Layouts: layout.md
+      - Pop-ups: alerts.md
+      - Sizes: size.md
+      - Colors: colors.md
+      - Images: images.md
+      - Loops and sleeping: blocking.md
+      - Events: events.md
+      - Using tkinter: usingtk.md
+      - Getting help: gettinghelp.md
+  - Widgets:
+      - Overview: widgetoverview.md
+      - App: app.md
+      - Box: box.md
+      - ButtonGroup: buttongroup.md
+      - CheckBox: checkbox.md
+      - Combo: combo.md
+      - Drawing: drawing.md
+      - ListBox: listbox.md
+      - MenuBar: menubar.md
+      - Picture: picture.md
+      - PushButton: pushbutton.md
+      - Slider: slider.md
+      - Text: text.md
+      - TextBox: textbox.md
+      - TitleBox: titlebox.md
+      - Waffle: waffle.md
+      - Window: window.md
+  - Recipes: recipes.md
+  - Book : book.md
+  - Contributing:
+      - Notes: contributing.md
+      - Developing: development.md
+      - Deploying: deployment.md
+  - Change log: changelog.md