diff --git a/doc/pages/README.md b/doc/pages/README.md
index 17063ef3ba00b71638dfaa21c43374b0cc96ac9a..7337120298f21a1c7fea84c37abafbf5568054d7 100644
--- a/doc/pages/README.md
+++ b/doc/pages/README.md
@@ -19,7 +19,8 @@ deploy static pages for your individual projects, your user or your group.
 **Table of Contents**  *generated with [DocToc](https://github.com/thlorenz/doctoc)*
 
 - [Getting started with GitLab Pages](#getting-started-with-gitlab-pages)
-    - [GitLab pages per user or group](#gitlab-pages-per-user-or-group)
+    - [GitLab pages per user](#gitlab-pages-per-user)
+    - [GitLab pages per group](#gitlab-pages-per-group)
     - [GitLab pages per project](#gitlab-pages-per-project)
     - [Explore the contents of .gitlab-ci.yml](#explore-the-contents-of-gitlab-ci-yml)
     - [Remove the contents of your pages](#remove-the-contents-of-your-pages)
@@ -68,7 +69,7 @@ as namespaces. There can be only one namespace in a GitLab instance.
 > There are some known [limitations](#limitations) regarding namespaces served
 > under the general domain name and HTTPS. Make sure to read that section.
 
-### GitLab pages per user or group
+### GitLab pages per user
 
 Head over your GitLab instance that supports GitLab Pages and create a
 repository named `username.example.io`, where `username` is your username on
@@ -79,19 +80,25 @@ username, it won’t work, so make sure to get it right.
 
 ---
 
-To create a group page the steps are exactly the same. Just make sure that
-you are creating the project within the group's namespace.
-
 After you upload some static content to your repository, you will be able to
 access it under `http(s)://username.example.io`. Keep reading to find out how.
 
+### GitLab pages per group
+
+To create a group page the steps are the same like when creating a website for
+users. Just make sure that you are creating the project within the group's
+namespace.
+
+After you upload some static content to your repository, you will be able to
+access it under `http(s)://groupname.example.io`.
+
 ### GitLab pages per project
 
 > **Note:**
 > You do _not_ have to create a project named `username.example.io` in order to
 > serve a project's page.
 
-GitLab Pages for projects 
+
 
 ### Explore the contents of .gitlab-ci.yml