diff --git a/README.md b/README.md
index 49399f3..9ae2664 100644
--- a/README.md
+++ b/README.md
@@ -3,6 +3,6 @@ This is a service providing configuration files for [ebusd](https://github.com/j
 
 The CSV files currently consumed by [ebusd](https://github.com/john30/ebusd) are generated from TypeSpec source files found in the [`src` folder of ebusd-configuration](https://github.com/john30/ebusd-configuration/tree/master/src) and converted to CSV using the [eBUS TypeSpec library](https://github.com/john30/ebus-typespec). The conversion process is described there in detail.
 
-The source files are taken from the commit associated with the submodule [ebusd-configuration](ebusd-configuration) here and the mapping from those to the generated CSV files is also re-generated with each update and [documented here](mapping.md).
+The source files are taken from the commit associated with the submodule `ebusd-configuration` in [this repository](https://github.com/eBUS/ebus.github.io) and the mapping from those to the generated CSV files is also re-generated with each update and [documented here](mapping.md).
 
-Take a look in the [`next/` folder](next/) for using the next upcoming release of the main folder.
+Take a look at the [`next/` folder](next/) for using the next upcoming release of the main folder.
diff --git a/next/README.md b/next/README.md
index 7556185..413cde6 100644
--- a/next/README.md
+++ b/next/README.md
@@ -1,4 +1,4 @@
 # Description
-This folder contains the next upcoming release of the main folder and can be used for inspection by pointing ebusd to the base folder with the "--configpath=https://ebus.github.io/next/" argument to ebusd.
+This folder contains the next upcoming release of the main folder and can be used for inspection by pointing ebusd to the base folder with the "`--configpath=https://ebus.github.io/next/`" argument to ebusd.
 
-The source files are taken from the commit associated with the submodule [ebusd-configuration-next](../ebusd-configuration-next) here and the mapping from those to the generated CSV files is also re-generated with each update and [documented here](mapping.md).
+The source files are taken from the commit associated with the submodule `ebusd-configuration-next` (watch the "-next" suffix!) in [this repository](https://github.com/eBUS/ebus.github.io) and the mapping from those to the generated CSV files is also re-generated with each update and [documented here](mapping.md).