docs(README): update build section

- remove trailing spaces
- revise doc structure
- remove local-startup.sh script and replace with make target
- list port application is running under

Author: FabianUntermoser

README.md

@@ -4,28 +4,33 @@
 This is the relaunch of the new www.vim.org website. We have found a small team that will take on the
 beautiful task of rebuilding the website with current design and new concepts.
 
-The new development should not take place behind closed doors, we want to 
+The new development should not take place behind closed doors, we want to
 make the new development public and transparent for you.
 
 Soon there will be a test system where you can follow the current status successively.
 
 Of course, we will involve you, the community, in the design by collecting ideas and feedback.
 
-# Getting started
+# Build
 
-## Prerequisites
+Prerequisites
 
-* docker
+* docker & docker-compose
+* npm
 
-## Quick start
+### Getting started
 
-The application can be run locally by executing the bash script `local-startup.sh`.
+Run the application locally with these make commands `make dev`.
 
-## Manual start
+This will setup default configuration (including dummy secrets),
+install npm dependencies and start the application using docker on port `3000`.
 
-The following steps must be carried out: 
+### Build locally
+
+The following steps must be carried out:
 1. Copy contents of `.env.example` files on `root`, `root/cms` and `root/web` into `.env` file
-2. Execute docker-compose file for local environment with the following command: `docker compose -f docker-compose.local.yml up `
+2. Install npm dependencies with `npm install` in the `root`, `root/cms` and `root/web` folder.
+3. Startup: `docker compose -f docker-compose.local.yml up`
 
 For more information about the headless CMS used in this project, visit the official documentation: https://docs.strapi.io/
 
@@ -44,7 +49,7 @@ Add your requirements here:
 ## Non-Functional Requirements
 
 * We want to continue using MySQL 8 as the database system.
-* We want the website to be fundamentally secure and avoid typical web application vulnerabilities (like SQL injection, XSS, ...) by design. 
+* We want the website to be fundamentally secure and avoid typical web application vulnerabilities (like SQL injection, XSS, ...) by design.
 * The hashing of the user passwords is to be migrated to a hashing procedure that corresponds to the state of the art.
 * The frontend/backend stack shall:
   - should be maintainable and expandable in the future with reasonable effort

local-startup.sh

@@ -56,14 +56,14 @@ install:
 
 init-env:
 	test -f .env || cp .env.example .env
-	test -f web/.env || cp .env.example web/.env
+	cd web/ && ( test -f .env || cp .env.example .env )
 	cd cms/ && ( test -f .env || cp .env.example .env )
 	@echo '-----------------------------------------------------'
-	@echo 'please update the .env files with the missing secrets'
+	@echo 'please update the default secrets in the .env files'
 
 check-env:
 	./scripts/check-env.sh .env.example .env
-	./scripts/check-env.sh .env.example web/.env
+	./scripts/check-env.sh web/.env.example web/.env
 	./scripts/check-env.sh cms/.env.example cms/.env
 
 logs: