diff --git a/content/getting-started/directory-structure.md b/content/getting-started/directory-structure.md
index b2d1face1..d331b0a1e 100644
--- a/content/getting-started/directory-structure.md
+++ b/content/getting-started/directory-structure.md
@@ -9,10 +9,129 @@ categories: [project organization]
tags: [source, organization, directories,fundamentals]
weight: 50
draft: false
+needsreview: true
aliases: [/overview/source-directory/]
notesforauthors:
---
+
+
+Hugo takes a single directory and uses it as the input for creating a complete
+website.
+
+
+The top level of a source directory will typically have the following elements:
+
+```bash
+▸ archetypes/
+▸ content/
+▸ data/
+▸ i18n/
+▸ layouts/
+▸ static/
+▸ themes/
+ config.toml
+```
+
+Learn more about the different directories and what their purpose is:
+
+* [config](/getting-started/configuration/)
+* [data](/templates/data-templates/)
+* [i18n](/content-management/multilingual-mode/)
+* [archetypes](/content-management/archetypes/)
+* [content](/content-managemt/content-organization/)
+* [layouts](/templates/)
+* [static](/themes/creating-a-theme/)
+* [themes](/themes/)
+
+
+## Example
+
+An example directory may look like:
+
+```bash
+.
+├── config.toml
+├── archetypes
+| └── default.md
+├── content
+| ├── post
+| | ├── firstpost.md
+| | └── secondpost.md
+| └── quote
+| | ├── first.md
+| | └── second.md
+├── data
+├── i18n
+├── layouts
+| ├── _default
+| | ├── single.html
+| | └── list.html
+| ├── partials
+| | ├── header.html
+| | └── footer.html
+| ├── taxonomies
+| | ├── category.html
+| | ├── post.html
+| | ├── quote.html
+| | └── tag.html
+| ├── post
+| | ├── li.html
+| | ├── single.html
+| | └── summary.html
+| ├── quote
+| | ├── li.html
+| | ├── single.html
+| | └── summary.html
+| ├── shortcodes
+| | ├── img.html
+| | ├── vimeo.html
+| | └── youtube.html
+| ├── index.html
+| └── sitemap.xml
+├── themes
+| ├── hyde
+| └── doc
+└── static
+ ├── css
+ └── js
+```
+
+This directory structure tells us a lot about this website:
+
+1. The website intends to have two different types of content: *posts* and *quotes*.
+2. It will also apply two different taxonomies to that content: *categories* and *tags*.
+3. It will be displaying content in 3 different views: a list, a summary, and a full-page view.
+
+## Content for Home Page and Other List Pages
+
+Since Hugo 0.18, "everything" is a `Page` that can have content and metadata, like `.Params`, attached to it -- and share the same set of [page variables](/variables-and-params/page-variables/).
+
+To add content and front matter to the home page, a section, a taxonomy or a taxonomy terms listing, add a markdown file with the base name `_index` on the relevant place on the file system.
+
+For the default Markdown content, the filename will be `_index.md`.
+
+Se the example directory tree below.
+
+**Note that you don't have to create `_index` file for every section, taxonomy and similar, a default page will be created if not present, but with no content and default values for `.Title` etc.**
+
+```bash
+└── content
+ ├── _index.md
+ ├── categories
+ │ ├── _index.md
+ │ └── photo
+ │ └── _index.md
+ ├── post
+ │ ├── _index.md
+ │ └── firstpost.md
+ └── tags
+ ├── _index.md
+ └── hugo
+ └── _index.md
+```
+
+
* **archetypes**: You can create new content files in Hugo using the `hugo new` command. When you run that command, it adds few configuration properties to the post like date and title. [Archetype][archetypes] allows you to define your own configuration properties that will be added to front matter of new content files whenever `hugo new` command is used.
diff --git a/content/getting-started/using-the-hugo-docs.md b/content/getting-started/using-the-hugo-docs.md
index 4ad9e2a2d..47bf60aca 100644
--- a/content/getting-started/using-the-hugo-docs.md
+++ b/content/getting-started/using-the-hugo-docs.md
@@ -12,6 +12,7 @@ draft: false
slug:
aliases: [/getting-started/using-the-docs/]
toc: true
+needsreview: true
notesforauthors:
needsreview: true
---
diff --git a/content/news/release-notes.md b/content/news/release-notes.md
index 4368f3697..81acde7c1 100644
--- a/content/news/release-notes.md
+++ b/content/news/release-notes.md
@@ -48,7 +48,8 @@ We wish you all a Merry Christmas and a Happy New Year.
## Highlights
The primary new feature in Hugo 0.18 is that every piece of content is now a `Page` ({{}}).
-This means that every page, including the home page, can have a content file with frontmatter.
+This means that every page, including the home page, can have a content file with front matter.
+
Not only is this a much simpler model to understand, it is also faster and paved the way for several important new features:
* Enable proper titles for Nodes {{}}