diff --git a/README.md b/README.md
index 89aab831..bf28c460 100644
--- a/README.md
+++ b/README.md
@@ -30,7 +30,7 @@ Please follow the instructions for your platform:
 
 > According to our tests, at least 1GB of RAM is needed to compile Twister.
 
-Alternatively, you can run Twister on an isolated Linux container, using [Docker](http://docker.io/). First, [install Docker on your system](https://docs.docker.com/installation/#installation). Then run:
+Alternatively, you can run Twister on an isolated Linux container, using [Docker](https://www.docker.com/). First, [install Docker on your system](https://docs.docker.com/installation/#installation). Then run:
 
     # Leave out the "sudo -E" if you added yourself to the "docker" group
     sudo -E ./twister-on-docker run --remote
diff --git a/doc/build-osx.md b/doc/build-osx.md
index 1c40706b..4b6876ef 100644
--- a/doc/build-osx.md
+++ b/doc/build-osx.md
@@ -27,7 +27,7 @@ it's the path of least resistance to install
 [Git for OS X](https://code.google.com/p/git-osx-installer/). It is also
 available via Homebrew or MacPorts.
 
-You will also need to install [Homebrew](http://mxcl.github.io/homebrew/)
+You will also need to install [Homebrew](http://brew.sh/)
 or [MacPorts](https://www.macports.org/) in order to install library
 dependencies. It's largely a religious decision which to choose, but I tested only with
 Homebrew.
@@ -36,7 +36,7 @@ The installation of the actual dependencies is covered in the Instructions
 sections below.
 
 
-Instructions: HomeBrew
+Instructions: Homebrew
 ----------------------
 
 #### Install dependencies using Homebrew
@@ -56,7 +56,7 @@ Instructions: HomeBrew
         ./autotool.sh
         ./configure --enable-logging --with-openssl=/usr/local/opt/openssl --with-libdb=/usr/local/opt/berkeley-db4
         make
-(If you have multi core CPU, use "make -j N" where N = number of your cores)
+(If you have multi core CPU, use "make -j N" where N = the number of your cores)
 
 3. If things go south, before trying again, make sure you clean it up: