Merge branch 'create-group' into 'master'

New doc about creating groups

I added a new document about creating groups in GitLab.

I also fixed comment in previous MR https://dev.gitlab.org/gitlab/gitlabhq/merge_requests/1885


See merge request !1886

6 files changed, 46 insertions, 1 deletions

diff --git a/doc/gitlab-basics/README.md b/doc/gitlab-basics/README.md
index fd55c44a2c4..3e4400b544b 100644
--- a/doc/gitlab-basics/README.md
+++ b/doc/gitlab-basics/README.md
@@ -11,3 +11,5 @@ Step-by-step guides on the basics of working with Git and GitLab.
 * [Basic Git commands](basic-git-commands.md)
 
 * [Create a project](create-project.md)
+
+* [Create a group](create-group.md)
diff --git a/doc/gitlab-basics/basicsimages/click-on-new-group.png b/doc/gitlab-basics/basicsimages/click-on-new-group.png
new file mode 100644
index 00000000000..94b6d5756d3
--- /dev/null
+++ b/doc/gitlab-basics/basicsimages/click-on-new-group.png
diff --git a/doc/gitlab-basics/basicsimages/select-group.png b/doc/gitlab-basics/basicsimages/select-group.png
new file mode 100644
index 00000000000..d02c2255ff2
--- /dev/null
+++ b/doc/gitlab-basics/basicsimages/select-group.png
diff --git a/doc/gitlab-basics/basicsimages/select-group2.png b/doc/gitlab-basics/basicsimages/select-group2.png
new file mode 100644
index 00000000000..fd40bce499b
--- /dev/null
+++ b/doc/gitlab-basics/basicsimages/select-group2.png
diff --git a/doc/gitlab-basics/command-line-commands.md b/doc/gitlab-basics/command-line-commands.md
index 30f78d1e6a5..a596bf20c74 100644
--- a/doc/gitlab-basics/command-line-commands.md
+++ b/doc/gitlab-basics/command-line-commands.md
@@ -2,7 +2,7 @@
 
 ## Start working on your project
 
-* In Git, when you copy a project you say you "clone" it. To work on a git project locally (from your own computer), you will need to clone it. To do this, start by signing in at GitLab.com.. To do it, go to your [GitLab.com](https://gitlab.com) account
+* In Git, when you copy a project you say you "clone" it. To work on a git project locally (from your own computer), you will need to clone it. To do this, sign in to [GitLab.com](https://gitlab.com)
 
 * When you are on your Dashboard, click on the project that you'd like to clone, which you'll find at the right side of your screen
 
diff --git a/doc/gitlab-basics/create-group.md b/doc/gitlab-basics/create-group.md
new file mode 100644
index 00000000000..8e168395ff7
--- /dev/null
+++ b/doc/gitlab-basics/create-group.md
@@ -0,0 +1,43 @@
+# How to create a group in GitLab
+
+## Create a group
+
+Your projects in [GitLab.com](https://gitlab.com) can be organized in 2 different ways:
+under your own namespace for single projects, such as ´your-name/project-1'; or under groups.
+If you organize your projects under a group, it works like a folder. You can manage your group members' permissions and access to the projects.
+
+To create a group, follow the instructions below:
+
+Sign in to [GitLab.com](https://gitlab.com).
+
+When you are on your Dashboard, click on "Groups" on the left menu of your screen:
+
+![Go to groups](basicsimages/select-group2.png)
+
+Click on "New group" on the top right side of your screen:
+
+![New group](basicsimages/click-on-new-group.png)
+
+Fill out the information required:
+
+1. Add a group path or group name (you can't add spaces, so you can use hyphens or underscores)
+
+1. Add details or a group description
+
+1. You can choose a group avatar if you'd like
+
+1. Click on "create group"
+
+![Group information](basicsimages/group_info.png)
+
+## Add a project to a group
+
+There are 2 different ways to add a new project to a group:
+
+* Select a group and then click on "New project" on the right side of your screen. Then you can [create a project](create-project.md)
+
+![New project](basicsimages/new_project.png)
+
+* When you are [creating a project](create-project.md), click on "create a group" on the bottom right side of your screen
+
+![Create a group](basicsimages/create_group.png)