1 files changed, 27 insertions, 0 deletions
diff --git a/doc/development/object_state_models.md b/doc/development/object_state_models.md
index e69de29bb2d..bb97b17e83f 100644
--- a/doc/development/object_state_models.md
+++ b/doc/development/object_state_models.md
@@ -0,0 +1,27 @@
+# Object state models
+
+## Contents
+* [Diagrams](#diagrams)
+* [Legend](#legend)
+* [Issue](#issue)
+* [Merge request](#merge-request)
+
+## Diagrams
+[GitLab object state models](https://drive.google.com/drive/u/3/folders/0B5tDlHAM4iZINmpvYlJXcDVqMGc)
+
+---
+
+## Legend
+![legend](img/state-model-legend.png)
+
+--- 
+
+## Issue
+[`app/models/issue.rb`](https://gitlab.com/gitlab-org/gitlab-ce/blob/master/app/models/issue.rb)
+![issue](img/state-model-issue.png)
+
+--- 
+
+## Merge request
+[`app/models/merge_request.rb`](https://gitlab.com/gitlab-org/gitlab-ce/blob/master/app/models/merge_request.rb)
+![merge request](img/state-model-merge-request.png)
+\ No newline at end of file