diff --git a/README.md b/README.md
index a41ddeb64..4e40b6ead 100644
--- a/README.md
+++ b/README.md
@@ -94,7 +94,7 @@ repeat these steps to upgrade to future releases.
 
 ## Building
 
-* [Linux](docs/build-instructions/linux.md)
-* [macOS](docs/build-instructions/macos.md)
-* [FreeBSD](docs/build-instructions/freebsd.md)
-* [Windows](docs/build-instructions/windows.md)
+* [Linux](./docs/build-instructions/linux.md)
+* [macOS](./docs/build-instructions/macos.md)
+* [FreeBSD](./docs/build-instructions/freebsd.md)
+* [Windows](./docs/build-instructions/windows.md)
diff --git a/docs/README.md b/docs/README.md
index 4953f1da8..e9b6ff120 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -2,20 +2,20 @@
 
 ![Atom](https://cloud.githubusercontent.com/assets/72919/2874231/3af1db48-d3dd-11e3-98dc-6066f8bc766f.png)
 
-Most of the Atom user and developer documentation is contained in the [Atom Docs](https://github.com/atom/docs) repository.
+Most of the Atom user and developer documentation is contained in the [Atom Flight Manual](https://github.com/atom/flight-manual.atom.io) repository.
 
-In this directory you can only find very specific build and API level documentation. Some of this may eventually move to the docs repository as well.
+In this directory you can only find very specific build and API level documentation. Some of this may eventually move to the Flight Manual as well.
 
 ## Build documentation
 
 Instructions for building Atom on various platforms from source.
 
-* [macOS](build-instructions/macos.md)
-* [Windows](build-instructions/windows.md)
-* [Linux](build-instructions/linux.md)
-* [FreeBSD](build-instructions/freebsd.md)
+* [macOS](./build-instructions/macos.md)
+* [Windows](./build-instructions/windows.md)
+* [Linux](./build-instructions/linux.md)
+* [FreeBSD](./build-instructions/freebsd.md)
 
 ## Other documentation here
 
-* [apm REST API](apm-rest-api.md)
-* [Tips for contributing to packages](contributing-to-packages.md)
+* [apm REST API](./apm-rest-api.md)
+* [Tips for contributing to packages](./contributing-to-packages.md)