1 files changed, 79 insertions, 0 deletions
diff --git a/docs/gl_objects/epics.rst b/docs/gl_objects/epics.rst
new file mode 100644
index 0000000..2b1e23e
--- /dev/null
+++ b/docs/gl_objects/epics.rst
@@ -0,0 +1,79 @@
+#####
+Epics
+#####
+
+Epics
+=====
+
+Reference
+---------
+
+* v4 API:
+
+  + :class:`gitlab.v4.objects.GroupEpic`
+  + :class:`gitlab.v4.objects.GroupEpicManager`
+  + :attr:`gitlab.Gitlab.Group.epics`
+
+* GitLab API: https://docs.gitlab.com/ee/api/epics.html (EE feature)
+
+Examples
+--------
+
+List the epics for a group::
+
+    epics = groups.epics.list()
+
+Get a single epic for a group::
+
+    epic = group.epics.get(epic_iid)
+
+Create an epic for a group::
+
+    epic = group.epics.create({'title': 'My Epic'})
+
+Edit an epic::
+
+    epic.title = 'New title'
+    epic.labels = ['label1', 'label2']
+    epic.save()
+
+Delete an epic::
+
+    epic.delete()
+
+Epics issues
+============
+
+Reference
+---------
+
+* v4 API:
+
+  + :class:`gitlab.v4.objects.GroupEpicIssue`
+  + :class:`gitlab.v4.objects.GroupEpicIssueManager`
+  + :attr:`gitlab.Gitlab.GroupEpic.issues`
+
+* GitLab API: https://docs.gitlab.com/ee/api/epic_issues.html (EE feature)
+
+Examples
+--------
+
+List the issues associated with an issue::
+
+    ei = epic.issues.list()
+
+Associate an issue with an epic::
+
+    # use the issue id, not its iid
+    ei = epic.issues.create({'issue_id': 4})
+
+Move an issue in the list::
+
+    ei.move_before_id = epic_issue_id_1
+    # or
+    ei.move_after_id = epic_issue_id_2
+    ei.save()
+
+Delete an issue association::
+
+    ei.delete()