diff --git a/README b/README
index d400dc1..f07dfee 100644
--- a/README
+++ b/README
@@ -3,3 +3,48 @@
 git clone --recursive git@github.com:open-power/op-build.git
 . op-build-env
 op-build palmetto_defconfig && op-build
+
+Building on *64-bit* Ubuntu/Debian systems
+==========================================
+
+1. Install Ubuntu 14.04 or Debian 7.5 64-bit.
+2. Install the packages necessary for the build:
+> sudo apt-get install cscope ctags libx-dev libexpat-dev linbc6-dev-i386 gcc g++ git bison flex gcc-multilib g++-multilib
+3. Install PERL modules necessary for the build:
+> cpan install XML::Simple
+4. Override the /bin/dash default shell configuration, you want to answer "no":
+> sudo dpks-reconfigure dash
+5. Continue with the clone, environment setup, and build as noted above.
+
+Building on *64-bit* Fedora systems
+==========================================
+
+1. Install Fedora 20 64-bit.
+2. Install the packages necessary for the build:
+> sudo yum install vim gcc-c++ flex bison git ctags cscope cpan expat-devel patch glibc-devel-i686 libgcc.i686 zlib-devel libstdc++.i686
+3. Install PERL modules necessary for the build:
+> cpan install XML::Simple YAML XML::SAX Fatal Thread/Queue.pm Env
+
+Troubleshooting
+===============
+
+* If git is complaining about permissions when you clone op-build, try:
+> git clone --recursive git@github.com:open-power/op-build.git
+> cd op-build
+> git clone --recursive git@github.com:open-power/buildroot.git
+
+** or
+
+> git clone --recursive https://github.com/open-power/op-build.git
+> cd op-build
+> git clone --recursive https://github.com/open-power/buildroot.git
+
+(thanks to Erich Hauptli at IBM)
+
+* If make is complaining during skiboot link phases, revert make to version 3.81
+-- On Fedora
+--> sudo rpm -del --nodeps make
+--> sudo wget ftp://fr2.rpmfind.net/linux/centos/6.5/os/x86_64/Packages/make-3.81-20.el6.x86_64.rpm
+--> sudo rpm --install make-3.81-20.el6.x86_64.rpm
+
+(instructions for make reversion from http://curiositydrivendevelopment.blogspot.com)
\ No newline at end of file