Clarify node.js projects deployment in docs

Author: yamalight

README.md

@@ -23,7 +23,7 @@ Exoframe is a self-hosted tool that allows simple one-command deployments using
 - Simple update procedure for client, server and Traefik
 - Optional automatic subdomain assignment (i.e. every deployment gets its own subdomain)
 
-\* Traefik feature
+\* Feature provided by [Traefik](https://traefik.io/)
 
 ## Demo
 

docs/Basics.md

@@ -1,6 +1,6 @@
 # Basics
 
-### Concepts
+## Concepts
 
 - **Project** - one or more deployments grouped together (e.g. started via docker-compose)
 - **Deployment** - one and only one deployed service
@@ -18,7 +18,18 @@ Be aware though - execution of deployments will result in (1) new Docker images
 Depending on your project's complexity, this might require significant amount of resources during both steps resulting in failed deployments (note: if Docker goes out-of-memory during build, you will not get any specific error - just a failed deployment).  
 It is recommended to run Exoframe on a server with at least 1GB of RAM.
 
-### Commands
+## Supported project types
+
+Currently, Exoframe understands and can deploy the following project types:
+
+1. Static html based projects - will be deployed using [nginx](http://hub.docker.com/_/nginx) image
+2. Node.js based projects - will be deployed using [node:latest](https://hub.docker.com/_/node) image *
+3. Docker based project - will be deployed using your [Dockerfile](https://docs.docker.com/engine/reference/builder/)
+4. Docker-Compose based projects - will be deployed using your [docker-compose](https://docs.docker.com/compose/compose-file/) file
+
+\* There are two things to keep in mind for Node.js projects: (1) they are started via `npm start`, so make sure you have specified start script in your `package.json`; (2) by default port 80 is exposed, so you need to make your app listen on that port. If you'd like to execute your app in any different way or expose more ports - please use Dockerfile deployment method.
+
+## Commands
 
 | Command                | Description |
 | ---------------------- | ----------- |

docs/FAQ.md

@@ -1,26 +1,16 @@
 # FAQ
 
-### Is it ready for production?
+## Is it ready for production?
 
 Yes. We've been using it to deploy our project since May 2017 without any issues.  
 
-### Why do I need to enter username during login?
+## Why do I need to enter username during login?
 
 Username is just your ID that is used to distinguish your deployments from others.  
 Right now you have to enter it yourself. And you will only see deployments done with that username.  
 Currently, more than one user can use same username (so, all users with that username will see same deployments).
 
-### How does it work?
+## How does it work?
 
 Exoframe uses [Docker](https://www.docker.com/) to deploy your project and [Traefik](https://traefik.io/) to proxy requested domains and/or paths to deployed projects.  
 All the Docker configuration of your projects happens automatically. So after running the command, the only thing you need to do is wait a few seconds until your project have been built and deployed!
-
-### What kind of projects can I deploy with Exoframe?
-
-Currently, Exoframe understands and can deploy the following project types:
-
-1. static html based projects - will be deployed using [nginx](http://hub.docker.com/_/nginx) image
-2. node.js based projects - will be deployed using [node:alpine](https://hub.docker.com/_/node) image
-3. docker based project - will be deployed using your [Dockerfile](https://docs.docker.com/engine/reference/builder/)
-4. docker-compose based project - will be deployed using your [docker-compose](https://docs.docker.com/compose/compose-file/) file
-

docs/Links.md

@@ -1,12 +1,12 @@
 # Articles, video and related links
 
-### Articles
+## Articles
 
 - [Introducing Exoframe (beta) — self-hosted alternative to Now.sh](https://hackernoon.com/introducing-exoframe-beta-self-hosted-alternative-to-now-sh-80643f96b84b)
 - [Continuous deployment for your Node.js projects in 10 minutes with Exoframe](https://hackernoon.com/continuous-deployment-for-your-node-js-projects-in-10-minutes-with-exoframe-bdf48340c1be)
 - [Simplifying Docker management with Exoframe](https://hackernoon.com/simplifying-docker-management-with-exoframe-9275e92c7406)
 
-### Videos
+## Videos
 
 - [Introducing Exoframe - self-hosted Now.sh alternative](https://www.youtube.com/watch?v=VZnYKIoh5oA)
 - [Continuous Deployment for Node.js projects in 10 mins using Exoframe](https://www.youtube.com/watch?v=AEwLt5hmKYo)