(docs) Add Helm charts, cleanup (#2944)

* (docs) Add Helm charts, cleanup

* (docs) Add Helm charts, cleanup

docs/getting-started/deployment-helm.md

@@ -2,17 +2,18 @@
 id: deployment-helm
 title: Helm
 description: Documentation on Kubernetes and Helm Deployment
+sidebar_label: Kubernetes and Helm
 ---
 
 # Helm charts
 
-An example Backstage app can be deployed in Kubernetes using the [Backstage Helm
-charts][backstage-helm-charts]
+An example Backstage app can be deployed in Kubernetes using the
+[Backstage Helm charts](https://github.com/spotify/backstage/tree/master/contrib/chart/backstage)
 
 First, choose a DNS name where backstage will be hosted create a yaml file for
 your custom configuration.
 
-```
+```yaml
 appConfig:
   app:
     baseUrl: https://backstage.mydomain.com
@@ -26,7 +27,6 @@ appConfig:
   techdocs:
     storageUrl: https://backstage.mydomain.com/api/techdocs/static/docs
     requestUrl: https://backstage.mydomain.com/api/techdocs
-
 ```
 
 Then use it to run:
@@ -61,9 +61,4 @@ backstage-ingress   *       123.1.2.3       80      17m
 > **NOTE**: this is not a production ready deployment.
 
 For more information on how to customize the deployment check the
-[README][charts-readme].
-
-[backstage-helm-charts]:
-  (https://github.com/spotify/backstage/tree/master/contrib/chart/backstage)
-[charts-readme]:
-  (https://github.com/spotify/backstage/tree/master/contrib/chart/backstage/README.md)
+[README](https://github.com/spotify/backstage/tree/master/contrib/chart/backstage/README.md).

docs/getting-started/deployment-other.md

@@ -17,3 +17,33 @@ $ docker run --rm -it -p 7000:7000 -e APP_ENV=production -e NODE_ENV=development
 ```
 
 Then open http://localhost/ on your browser.
+
+## Heroku
+
+Deploying to Heroku is relatively easy following these steps.
+
+First, make sure you have the
+[heroku CLI installed](https://devcenter.heroku.com/articles/heroku-cli) and log
+into it as well as login into Heroku's
+[container registry](https://devcenter.heroku.com/articles/container-registry-and-runtime).
+
+```bash
+$ heroku login
+$ heroku container:login
+```
+
+You _might_ also need to set your Heroku app's stack to `container`
+
+```bash
+$ heroku stack:set container -a <your-app>
+```
+
+We can now build/push the Docker image to Heroku's container registry and
+release it to the `web` worker.
+
+```bash
+$ heroku container:push web -a <your-app>
+$ heroku container:release web -a <your-app>
+```
+
+With that, you should have Backstage up and running!

docs/getting-started/installation.md

@@ -1,7 +0,0 @@
----
-id: installation
-title: Installation
-description: Documentation on Installation
----
-
-Coming soon!