Merge pull request #1633 from spotify/blam/docker-compose

Simple docker-compose and docs reshuffle

docs/getting-started/deployment-other.md

@@ -0,0 +1,27 @@
+# Deployment (Other)
+
+## Deploying Locally
+
+### Try on Docker
+
+Run the following commands if you have Docker environment
+
+```bash
+$ yarn docker-build
+$ docker run --rm -it -p 80:80 spotify/backstage
+```
+
+Then open http://localhost/ on your browser.
+
+### Running with `docker-compose`
+
+Run the following commands if you have docker and docker-compose for a full
+example, with the example backend also deployed.
+
+```bash
+$ yarn docker-build:all
+$ docker-compose up
+```
+
+Then open http://localhost:3000 on your browser to see the example app with an
+example backend.

docs/getting-started/development-environment.md

@@ -80,17 +80,6 @@ yarn diff # Make sure all plugins are up to date with the latest plugin template
 yarn create-plugin # Create a new plugin
 ```
 
-### (Optional)Try on Docker
-
-Run the following commands if you have Docker environment
-
-```bash
-$ yarn docker-build
-$ docker run --rm -it -p 80:80 spotify/backstage
-```
-
-Then open http://localhost/ on your browser.
-
 > See [package.json](/package.json) for other yarn commands/options.
 
 [Next Step - Create a Backstage plugin](../plugins/create-a-plugin.md)