diff --git a/doc/workflow/README.md b/doc/workflow/README.md
index a2653704c3301a7821fd38f2f9361f13abcf14c3..c1a4f64981f8149d28973e52b9fb8fd26f8e3d21 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 0000000000000000000000000000000000000000..1cd1f0f2fc31479de2a3328e72045c382ab53353
--- /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 0000000000000000000000000000000000000000..de44c1ffc1a44c21e7d6eff77ff8752d84b6ea8f
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 0000000000000000000000000000000000000000..38862dcca6895c28a09c6173fc8a2d7b1552b528
Binary files /dev/null and b/doc/workflow/milestones/group_form.png differ