Merge pull request #419 from blackxored/better-docker-support

Better docker support

.dockerignore

+.git
+source

Dockerfile

-FROM ruby:2.2.3-onbuild
+FROM ruby:onbuild
+MAINTAINER Adrian Perez <adrian@adrianperez.org>
+VOLUME /usr/src/app/source
+EXPOSE 4567
 
-RUN ln -s /usr/src/app /app # Deprecated
+RUN apt-get update && apt-get install -y nodejs \
+&& apt-get clean && rm -rf /var/lib/apt/lists/*
 
-EXPOSE 4567
 CMD ["bundle", "exec", "middleman", "server", "--force-polling"]

README.md

@@ -47,23 +47,28 @@ You're going to need:
 2. Clone *your forked repository* (not our original one) to your hard drive with `git clone https://github.com/YOURUSERNAME/slate.git`
 3. `cd slate`
 4. Initialize and start (there are a few options for this):
- 
+
 #### Manual/local
 
 ```shell
 bundle install
 bundle exec middleman server
-```    
-#### Via Docker (must install Docker first)
+```
+
+#### Via Docker (must install it first)
 
 ```shell
-docker build -t slate .
-docker run -d -p 4567:4567 --name slate -v $(pwd)/source:/app/source slate
-```    
+docker-compose up
+```
+
+will spin an environment for you, with the `source` directory mapped to the
+container, so you can see your edits instantly after refreshing your browser.
 
-You can now see the docs at http://localhost:4567. Whoa! That was fast! 
+You can now see the docs at http://localhost:4567. Whoa! That was fast!
 
-*Note: if you're using the Docker setup on OSX, the docs will be availalable at the output of `boot2docker ip` instead of `localhost:4567`.*
++*Note: if you're not using Docker natively (i.e. on Linux), the docs will be
++available at the IP of your docker host. If you're using docker-machine you can
++retrieve it with `docker-machine ip <your_machine_name>`*
 
 #### Via Vagrant
 ```shell

docker-compose.yml

+app:
+  build: .
+  ports:
+    - 4567:4567
+  volumes:
+    - ./source:/usr/src/app/source