From c6ea4f3ae54e1c7b890dffb2243c0a81eb96b295 Mon Sep 17 00:00:00 2001
From: Henk Verlinde <henk@ventizo.com>
Date: Thu, 5 Nov 2020 21:09:30 +0100
Subject: [PATCH] docs: update content

---
 README.md                             | 11 +---
 content/docs/help/faq.md              |  9 ---
 content/docs/prologue/commands.md     | 94 +++++++++++++--------------
 content/docs/prologue/introduction.md | 11 +---
 package.json                          |  3 +-
 5 files changed, 52 insertions(+), 76 deletions(-)

diff --git a/README.md b/README.md
index db8e921..827f401 100644
--- a/README.md
+++ b/README.md
@@ -40,23 +40,18 @@ git clone https://github.com/h-enk/doks.git my-doks-site
 Install npm packages:
 
 ```bash
-# @ my-doks-site/
-$ npm install
+npm install
 ```
 
 Start local development server:
 
 ```bash
-# @ my-doks-site/
-$ npm run start
+npm run start
 ```
 
 ### Other commands
 
-- `npm run lint:styles` - Check Sass for errors
-- `npm run lint:scripts` - Check JavaScript for errors
-- `npm run clean` - Delete temporary directories
-- `npm run build` - Build production website
+Doks comes with [commands for most used tasks](https://getdoks.org/docs/prologue/commands/).
 
 ## Quick start
 
diff --git a/content/docs/help/faq.md b/content/docs/help/faq.md
index 6d76ec6..1b3e802 100644
--- a/content/docs/help/faq.md
+++ b/content/docs/help/faq.md
@@ -13,15 +13,6 @@ weight: 410
 toc: true
 ---
 
-## What's with the name?
-
-Hyas used [Atlas](https://github.com/indigotree/atlas) 🙏 as a starting point. In Greek mythology,
-[Hyas](https://www.greekmythology.com/Other_Gods/Minor_Gods/Hyas/hyas.html) was the son of the Titan Atlas and the Oceanid Aethra.
-
-## Can I get support?
-
-Visit [Hugo Discourse](https://discourse.gohugo.io/) and use the search. If that does not help, start a new topic and ask your question.
-
 ## Keyboard shortcuts for search?
 
 - focus: `/`
diff --git a/content/docs/prologue/commands.md b/content/docs/prologue/commands.md
index e309e63..3c328b8 100644
--- a/content/docs/prologue/commands.md
+++ b/content/docs/prologue/commands.md
@@ -1,7 +1,7 @@
 ---
 title: "Commands"
-description: "Repository commands."
-lead: "Repository commands."
+description: "Doks comes with commands for most used tasks."
+lead: "Doks comes with commands for most used tasks."
 date: 2020-10-13T15:21:01+02:00
 lastmod: 2020-10-13T15:21:01+02:00
 draft: false
@@ -13,48 +13,14 @@ weight: 030
 toc: true
 ---
 
+{{< alert icon="💡" text="You can change the commands in the scripts section of `./package.json`." >}}
+
 ## start
 
 Start local development server:
 
 ```bash
-yarn start
-```
-
-## build
-
-Build production website:
-
-```bash
-yarn build
-```
-
-### :functions
-
-```bash
-yarn build:functions
-```
-
-### :preview
-
-```bash
-yarn build:preview
-```
-
-## server
-
-Start local development server:
-
-```bash
-yarn server
-```
-
-## clean
-
-Delete temporary directories:
-
-```bash
-yarn clean
+npm run start
 ```
 
 ## lint
@@ -62,31 +28,61 @@ yarn clean
 Check scripts, styles, and markdown for errors:
 
 ```bash
-yarn lint
+npm run lint
 ```
 
-### :scripts
+### scripts
+
+Check scripts for errors:
 
 ```bash
-yarn lint:scripts [--fix]
+npm run lint:scripts [--fix]
 ```
 
-### :styles
+### styles
+
+Check styles for errors:
 
 ```bash
-yarn lint:styles [--fix]
+npm run lint:styles [--fix]
 ```
 
-### :markdown
+### markdown
+
+Check markdown for errors:
 
 ```bash
-yarn lint:markdown [--fix]
+npm run lint:markdown [--fix]
 ```
 
-## test
+## clean
 
-Check scripts, styles, and markdown for errors:
+Delete temporary directories:
 
 ```bash
-yarn test
+npm run clean
+```
+
+## build
+
+Build production website:
+
+```bash
+npm run build
+```
+
+### functions
+
+Build Lambda functions:
+
+```bash
+npm run build:functions
+```
+
+### preview
+
+Build production website including draft and future content:
+
+```bash
+npm run build:preview
 ```
diff --git a/content/docs/prologue/introduction.md b/content/docs/prologue/introduction.md
index 72a2414..96f877e 100644
--- a/content/docs/prologue/introduction.md
+++ b/content/docs/prologue/introduction.md
@@ -47,23 +47,18 @@ git clone https://github.com/h-enk/doks.git my-doks-site
 Install npm packages:
 
 ```bash
-# @ my-doks-site/
-$ npm install
+npm install
 ```
 
 Start local development server:
 
 ```bash
-# @ my-doks-site/
-$ npm run start
+npm run start
 ```
 
 ### Other commands
 
-- `npm run lint:styles` - Check Sass for errors
-- `npm run lint:scripts` - Check JavaScript for errors
-- `npm run clean` - Delete temporary directories
-- `npm run build` - Build production website
+Doks comes with [commands for most used tasks]({{< ref "commands" >}}).
 
 ## Quick start
 
diff --git a/package.json b/package.json
index 443c164..b465810 100644
--- a/package.json
+++ b/package.json
@@ -6,11 +6,10 @@
     "defaults"
   ],
   "scripts": {
-    "start": "hugo server --disableFastRender",
+    "start": "hugo server",
     "build": "hugo --gc --minify && npm run build:functions",
     "build:functions": "netlify-lambda build assets/lambda",
     "build:preview": "npm run build -D -F",
-    "server": "hugo server",
     "clean": "rimraf public resources functions",
     "lint": "npm run -s lint:scripts && npm run -s lint:styles && npm run -s lint:markdown",
     "lint:scripts": "eslint assets/js assets/lambda config",