From 1a271281143d42a91bd70f50900177fa5a1af3e2 Mon Sep 17 00:00:00 2001
From: James Ramsay <jramsay@gitlab.com>
Date: Thu, 14 Jun 2018 13:46:45 +0000
Subject: [PATCH] Increase detail

---
 CONTRIBUTING.md | 16 +++++++++++-----
 1 file changed, 11 insertions(+), 5 deletions(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 2309743612c9..aa39b5683a45 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -312,11 +312,17 @@ needed until the solution has been decided.
 
 ~"design artifact" issues are like any other issue and should contain a milestone label, ~"Deliverable" or ~"Stretch", when scheduled in the current milestone.
 
-To prevent the misunderstanding that a feature will be be delivered in the assigned milestone, when only UX design is
-planned, the Product Manager should create an issue specifically for the ~"design artifact" with a title that makes
-this clear (e.g. `Design exploration for XYZ`).
-
-Once the ~"design artifact" issue has been completed, the UXer removes the ~"design artifact" label and applies the ~"UX ready" label.
+To prevent the misunderstanding that a feature will be be delivered in the
+assigned milestone, when only UX design is planned for that milestone, the
+Product Manager should create a separate issue for the ~"design artifact",
+assign the ~UX, ~"design artifact" and ~"Deliverable" labels, add a milestone
+and use a title that makes it clear that the scheduled issue is design only
+(e.g. `Design exploration for XYZ`).
+
+When the ~"design artifact" issue has been completed, the UXer removes the ~UX
+and ~"design artifact" labels, adds the ~"UX ready" label and closes the issue.
+This indicates the design artifact is complete. The UXer will also copy the
+designs to related issues for implementation in an upcoming milestone.
 
 ## Issue tracker
 
-- 
GitLab