diff --git a/doc/workflow/README.md b/doc/workflow/README.md
index a2653704c33..c1a4f64981f 100644
--- a/doc/workflow/README.md
+++ b/doc/workflow/README.md
@@ -14,5 +14,6 @@
 - [Protected branches](protected_branches.md)
 - [Web Editor](web_editor.md)
 - [Releases](releases.md)
+- [Milestones](milestones.md)
 - [Merge Requests](merge_requests.md)
 - ["Work In Progress" Merge Requests](wip_merge_requests.md)
diff --git a/doc/workflow/milestones.md b/doc/workflow/milestones.md
new file mode 100644
index 00000000000..1cd1f0f2fc3
--- /dev/null
+++ b/doc/workflow/milestones.md
@@ -0,0 +1,13 @@
+# Milestones
+
+Milestone allows you to group issues and set due date for it. 
+Milestone is created per project. 
+
+![milestone form](milestones/form.png)
+
+## Groups and milestones
+
+You can create milestone with single form for several projects that belongs to the same group.
+On the group milestones page you will be able to see this milestones grouped together by name.
+
+![group milestone form](milestones/group_form.png)
diff --git a/doc/workflow/milestones/form.png b/doc/workflow/milestones/form.png
new file mode 100644
index 00000000000..de44c1ffc1a
Binary files /dev/null and b/doc/workflow/milestones/form.png differ
diff --git a/doc/workflow/milestones/group_form.png b/doc/workflow/milestones/group_form.png
new file mode 100644
index 00000000000..38862dcca68
Binary files /dev/null and b/doc/workflow/milestones/group_form.png differ