diff --git a/docs/src/01_overview.md b/docs/src/01_overview.md
index c0829c83b..a522e5c14 100644
--- a/docs/src/01_overview.md
+++ b/docs/src/01_overview.md
@@ -37,6 +37,6 @@ released version of Druid (v0.8).
 [Flutter]: https://flutter.dev
 [Jetpack Compose]: https://developer.android.com/jetpack/compose
 [SwiftUI]: https://developer.apple.com/documentation/swiftui
-[the `Data` trait]: ./data.md
-[the `Widget` trait]: ./widget.md
-[the `Lens` trait]: ./lens.md
+[the `Data` trait]: ./03_data.md
+[the `Widget` trait]: ./04_widget.md
+[the `Lens` trait]: ./05_lens.md
diff --git a/docs/src/04_widget.md b/docs/src/04_widget.md
index 63e8e26ae..16e56c636 100644
--- a/docs/src/04_widget.md
+++ b/docs/src/04_widget.md
@@ -93,8 +93,8 @@ a stack of three labels, you can do:
 {{#include ../book_examples/src/widget_md.rs:flex_builder}}
 ```
 
-[`Data`]: ./data.md
-[`Lens`]: ./lens.md
+[`Data`]: ./03_data.md
+[`Lens`]: ./05_lens.md
 [box layout model]: https://api.flutter.dev/flutter/rendering/BoxConstraints-class.html
-[Creating custom widgets]: ./custom_widgets.md
+[Creating custom widgets]: ./08_widgets_in_depth.md
 [builder pattern]: https://doc.rust-lang.org/1.0.0/style/ownership/builders.html
diff --git a/docs/src/06_env.md b/docs/src/06_env.md
index a521f020d..c98469fd9 100644
--- a/docs/src/06_env.md
+++ b/docs/src/06_env.md
@@ -82,7 +82,6 @@ calling its [`resolve`] method.
 [`Value`]: https://docs.rs/druid/latest/druid/enum.Value.html
 [`LocalizedString`]: https://docs.rs/druid/latest/druid/struct.LocalizedString.html
 [`resolve`]: https://docs.rs/druid/latest/druid/struct.LocalizedString.html#method.resolve
-[localization]: ./localization.md
 [reverse-DNS]: https://en.wikipedia.org/wiki/Reverse_domain_name_notation
 [`AppLauncher::configure_env`]: https://docs.rs/druid/latest/druid/struct.AppLauncher.html#method.configure_env
 [`KeyOrValue`]: https://docs.rs/druid/latest/druid/enum.KeyOrValue.html
diff --git a/docs/src/08_widgets_in_depth.md b/docs/src/08_widgets_in_depth.md
index b4cad35a5..e906d485b 100644
--- a/docs/src/08_widgets_in_depth.md
+++ b/docs/src/08_widgets_in_depth.md
@@ -66,10 +66,10 @@ textbox fire some action (say doing a search) 300ms after the last keypress:
 {{#include ../book_examples/src/custom_widgets_md.rs:annoying_textbox}}
 ```
 
-[`Controller`]: https://docs.rs/druid/0.8.3/druid/widget/trait.Controller.html
-[`Widget`]: ./widget.md
-[`Painter`]: https://docs.rs/druid/0.8.3/druid/widget/struct.Painter.html
-[`SizedBox`]: https://docs.rs/druid/0.8.3/druid/widget/struct.SizedBox.html
-[`Container`]: https://docs.rs/druid/0.8.3/druid/widget/struct.Container.html
-[`WidgetExt`]: https://docs.rs/druid/0.8.3/druid/trait.WidgetExt.html
-[`background`]: https://docs.rs/druid/0.8.3/druid/trait.WidgetExt.html#background
+[`Controller`]: https://docs.rs/druid/latest/druid/widget/trait.Controller.html
+[`Widget`]: ./04_widget.md
+[`Painter`]: https://docs.rs/druid/latest/druid/widget/struct.Painter.html
+[`SizedBox`]: https://docs.rs/druid/latest/druid/widget/struct.SizedBox.html
+[`Container`]: https://docs.rs/druid/latest/druid/widget/struct.Container.html
+[`WidgetExt`]: https://docs.rs/druid/latest/druid/trait.WidgetExt.html
+[`background`]: https://docs.rs/druid/latest/druid/trait.WidgetExt.html#background