From d9e467b8b7b15f616c2a83335d5b47d256cfeebd Mon Sep 17 00:00:00 2001
From: Witold Baryluk <witold.baryluk+github@gmail.com>
Date: Tue, 26 Mar 2019 08:18:08 +0000
Subject: [PATCH] Actuall show how to generate pages in quickstart

The development server isn't really that important for quick start.

Yes it is useful but makes things complex.

The most important part is really static site generation, and it is actually hard to find how to do it in your tutorials!

Same for `hugo new`. It is automagic, and anti-thesis of things being simple. This is why I added section to make it less magic, and simply allow content to be done manually.
---
 content/en/getting-started/quick-start.md | 25 ++++++++++++++++++++++-
 1 file changed, 24 insertions(+), 1 deletion(-)

diff --git a/content/en/getting-started/quick-start.md b/content/en/getting-started/quick-start.md
index b1b5fec316..d090bc0006 100644
--- a/content/en/getting-started/quick-start.md
+++ b/content/en/getting-started/quick-start.md
@@ -83,16 +83,27 @@ echo 'theme = "ananke"' >> config.toml
 
 {{< asciicast 7naKerRYUGVPj8kiDmdh5k5h9 >}}
 
+
 ## Step 4: Add Some Content
 
+You can manually create content files (for example as `content/<CATEGORY>/<FILE>.<FORMAT>`) and provide metadata in them, however you can use `new` commend to do few things for you (like add title and date):
+
 ```
 hugo new posts/my-first-post.md
 ```
 
 {{< asciicast eUojYCfRTZvkEiqc52fUsJRBR >}}
 
+Edit the newly created content file if you want, it will start with something like this:
 
-Edit the newly created content file if you want.
+```markdown
+---
+title: "My First Post"
+date: 2019-03-26T08:47:11+01:00
+draft: true
+---
+
+```
 
 
 ## Step 5: Start the Hugo server
@@ -130,6 +141,8 @@ Press Ctrl+C to stop
 
 **Navigate to your new site at [http://localhost:1313/](http://localhost:1313/).**
 
+Feel free to edit or add new content and simply refresh in browser to see changes quickly (You might need to force refresh in webbrowser, something like Ctrl-R usually works).
+
 
 ## Step 6: Customize the Theme
 
@@ -157,3 +170,13 @@ For theme specific configuration options, see the [theme site](https://github.co
 
 **For further theme customization, see [Customize a Theme](/themes/customizing/).**
 
+
+### Step 7: Build static pages
+
+It is simple. Just call:
+
+```
+hugo
+```
+
+Output will be in `./public/` directory by default (`-d`/`--destination` flag to change it, or set `publishdir` in the config file).