diff --git a/docs/modules/xosconfig.md b/docs/modules/xosconfig.md
index 6f3cb5c..53b2567 100644
--- a/docs/modules/xosconfig.md
+++ b/docs/modules/xosconfig.md
@@ -64,4 +64,6 @@
 "test"
 ```
 
-**The configuration schema is defined in `/lib/xos-config/config-schema.yaml`**
+> NOTE: The configuration schema is defined in
+> `/lib/xos-config/config-schema.yaml`
+
diff --git a/docs/tutorials/example_service.md b/docs/tutorials/example_service.md
index 0cfa008..b29c012 100644
--- a/docs/tutorials/example_service.md
+++ b/docs/tutorials/example_service.md
@@ -68,7 +68,7 @@
 A Virtual Pod includes a build machine, a head node, switches, and a compute
 node all running as VMs on a single host.  Before proceeding you should
 familiarize yourself with the CiaB environment and the [POD Development
-Loop](dev/workflow_pod.md#development-loop).
+Loop](../dev/workflow_pod.md#development-loop).
 
 ## Create the synchronizer directory
 
@@ -89,11 +89,10 @@
 
 Your models live in a file named `exampleservice.xproto` in your service's
 `xos/synchronizer/models` directory. This file encodes the models in the
-service in a format called [xproto](../xos/dev/xproto.md) which is a
-combination of Google Protocol Buffers and some XOS-specific annotations to
-facilitate the generation of service components, such as the GRPC and REST
-APIs, security policies, and database models among other things. It consists of
-two parts:
+service in a format called [xproto](../dev/xproto.md) which is a combination of
+Google Protocol Buffers and some XOS-specific annotations to facilitate the
+generation of service components, such as the GRPC and REST APIs, security
+policies, and database models among other things. It consists of two parts:
 
 * The XPROTO Header, which contains options that are global to the rest of the file.
 
diff --git a/docs/xos_internals.md b/docs/xos_internals.md
index 2d0c052..951dcd2 100644
--- a/docs/xos_internals.md
+++ b/docs/xos_internals.md
@@ -14,7 +14,7 @@
 | xos-ws | Listens to `redis` events and propagates them over web-sockets for notifications| 3000|
 | xos-chameleon | Northbound REST interface, accessible at `/xosapi/v1/..` (`swagger` is published at `/apidocs/`| 3000|
 
-All the communication between containers happen over `gRPC` except for `xos-gui` 
-where it is a combination of REST and web-socket.
+All the communication between containers happen over `gRPC` except for
+`xos-gui` where it is a combination of REST and web-socket.
 
 ![xos-containers](./static/xos_containers.png)