<html><head><meta http-equiv="Content-Type" content="text/html charset=windows-1252"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;"><br><div><div>On Mar 20, 2015, at 3:29 PM, Matt Carrano <<a href="mailto:mcarrano@redhat.com">mcarrano@redhat.com</a>> wrote:</div><br class="Apple-interchange-newline"><blockquote type="cite"><div style="font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px;"><br><br>----- Original Message -----<br>From: "Leslie Hinson" <<a href="mailto:lhinson@redhat.com">lhinson@redhat.com</a>><br>To: "Matt Carrano" <<a href="mailto:mcarrano@redhat.com">mcarrano@redhat.com</a>><br>Cc:<span class="Apple-converted-space"> </span><a href="mailto:patternfly@redhat.com">patternfly@redhat.com</a>, "uxd-team" <<a href="mailto:uxd-team@redhat.com">uxd-team@redhat.com</a>><br>Sent: Friday, March 20, 2015 3:22:10 PM<br>Subject: Re: [Patternfly] *Action Required - Terminology and Wording Sprint 2<br><br>Hey Matt,<span class="Apple-converted-space"> </span><br><br>Thanks for looking over these. The recommendation is not to use Create instead of Add. The intent of the guidelines is to distinguish the difference between Add/Create and Remove/Delete so that the correct label is applied appropriately. You have brought up a good use case where the user is initiating two actions (both create and add) with the click of one button. To me, this sounds like an additional requirement that could be added to the list to look at. If you are in agreement, I will add it to the list of to-dos to investigate for future sprints.<span class="Apple-converted-space"> </span><br><br>Yes, this makes sense.  I think there will be many cases where Create and Add will occur together in what appears like one atomic operation to the user.<br><br>I second your call for any other known cases of this as it will be helpful for any future work.<span class="Apple-converted-space"> </span><br></div></blockquote><div><br></div><div><br></div><div>FWIW…</div><div><br></div><div>RHEV uses the term “New” a lot. So they have just avoided the action verb. I’ve been introducing both Create and Add where applicable in the 4.0 designs. RHEV also has the concept of “Clone” for copy so +1 to Josephine’s request on standardizing something here…</div><div><br></div><div>OpenStack Horizon uses Create and Add where applicable. </div><div><br></div><div>Hope this helps!</div><div><br></div><div>Liz</div><br><blockquote type="cite"><div style="font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px;"><br>Regards,<span class="Apple-converted-space"> </span><br>Leslie<br><br><br><br><br><blockquote type="cite">On Mar 20, 2015, at 1:42 PM, Matt Carrano <<a href="mailto:mcarrano@redhat.com">mcarrano@redhat.com</a>> wrote:<br><br>I think this looks good.  I have only one question/comment about the usage of Add vs. Create (and consequently Remove vs. Delete).<br><br>I personally like the distinction between Add and Create and agree that Create is a more descriptive term when naming the action of instantiating a new object.  However, in the Middleware products I've worked on I have generally seen the term Add used to create a new object and add it to a list or table.  Curious how these terms are being used elsewhere (are the products I've worked on the exception?).  If we start promoting the use of the term Create instead of Add, will this cause an inconsistency with existing releases?<br><br>-Matt<br><br>----- Original Message -----<br>From: "Leslie Hinson" <<a href="mailto:lhinson@redhat.com">lhinson@redhat.com</a>><br>To: <a href="mailto:patternfly@redhat.com">patternfly@redhat.com</a>, "uxd-team" <<a href="mailto:uxd-team@redhat.com">uxd-team@redhat.com</a>><br>Sent: Thursday, March 19, 2015 7:58:42 PM<br>Subject: [Patternfly] *Action Required - Terminology and Wording Sprint 2<br><br>Hi all,<span class="Apple-converted-space"> </span><br>The Terminology and Wording Group's second sprint includes general rules and standards for the following:<span class="Apple-converted-space"> </span><br><br><br>  * Started to define Terminology and Wording for Action Labels. This list will continue to grow and we are taking requests.<span class="Apple-converted-space"> </span><br>  * Some more abbreviations were added for Days, Months and Units of Time<span class="Apple-converted-space"> </span><br>  * General rules and guidelines for Truncation<span class="Apple-converted-space"> </span><br><br>As part of our review process, we would like to gather feedback from you to ensure there are no major issues or concerns with the definitions below. Please provide your input by end of day on Friday, March 27. In addition, let us know of any new requests for us to address in future sprints.<span class="Apple-converted-space"> </span><br><br>Thanks, Leslie<span class="Apple-converted-space"> </span><br>Terminology and Wording for Action Labels<span class="Apple-converted-space"> </span><br><br>Label<span class="Apple-converted-space"> </span><br><span class="Apple-tab-span" style="white-space: pre;">    </span><br>Action<span class="Apple-converted-space"> </span><br><span class="Apple-tab-span" style="white-space: pre;"> </span><br>Complement<span class="Apple-converted-space"> </span><br><span class="Apple-tab-span" style="white-space: pre;">     </span><br>Notes<span class="Apple-converted-space"> </span><br><br>Add xxx<span class="Apple-converted-space"> </span><br>Add<span class="Apple-converted-space"> </span><br><span class="Apple-tab-span" style="white-space: pre;">    </span><br>Add an existing item to an existing list, group, view, or other container element<span class="Apple-converted-space"> </span><br><span class="Apple-tab-span" style="white-space: pre;">      </span><br>Remove<span class="Apple-converted-space"> </span><br><span class="Apple-tab-span" style="white-space: pre;"> </span><br>If what you are adding is not readily apparent from the context,<span class="Apple-converted-space"> </span><br>consider adding a noun to the button label (for example, Add<span class="Apple-converted-space"> </span><br>File, Add User).<span class="Apple-converted-space"> </span><br>Do not use Add to mean create a new item. See Create<span class="Apple-converted-space"> </span><br><br>Change<span class="Apple-converted-space"> </span><br><span class="Apple-tab-span" style="white-space: pre;">   </span><br>Not recommended. See Edit<span class="Apple-converted-space"> </span><br><br>Create xxx<span class="Apple-converted-space"> </span><br>Create<span class="Apple-converted-space"> </span><br><span class="Apple-tab-span" style="white-space: pre;">  </span><br>Create something new<span class="Apple-converted-space"> </span><br><span class="Apple-tab-span" style="white-space: pre;">   </span><br>Delete<span class="Apple-converted-space"> </span><br><span class="Apple-tab-span" style="white-space: pre;"> </span><br>If what you are creating is not readily apparent from the context,<span class="Apple-converted-space"> </span><br>consider adding a noun to the button label (for example, Create User, Create File, Create Device).<span class="Apple-converted-space"> </span><br>Not recommended:<span class="Apple-converted-space"> </span><br><br><br>  *<span class="Apple-converted-space"> </span><br>New<span class="Apple-converted-space"> </span><br><br>  *<span class="Apple-converted-space"> </span><br>Add (see Add for usage guidelines)<span class="Apple-converted-space"> </span><br><br><br>Delete<span class="Apple-converted-space"> </span><br><span class="Apple-tab-span" style="white-space: pre;">     </span><br>Removes the selected items.<span class="Apple-converted-space"> </span><br>Also see Undo.<span class="Apple-converted-space"> </span><br><br><span class="Apple-tab-span" style="white-space: pre;">   </span><br>Create<span class="Apple-converted-space"> </span><br><span class="Apple-tab-span" style="white-space: pre;"> </span><br>Provide a mechanism to reverse (undo) Delete.<span class="Apple-converted-space"> </span><br>Not recommended:<span class="Apple-converted-space"> </span><br><br><br>  *<span class="Apple-converted-space"> </span><br>Erase<span class="Apple-converted-space"> </span><br><br>  *<span class="Apple-converted-space"> </span><br>Remove (see Remove for usage guidelines).<span class="Apple-converted-space"> </span><br><br><br>Edit<span class="Apple-converted-space"> </span><br><span class="Apple-tab-span" style="white-space: pre;">      </span><br>Open a dialog box to make changes (to a file, configuration, policy, and so on).<span class="Apple-converted-space"> </span><br>Also see Rename.<span class="Apple-converted-space"> </span><br><br><span class="Apple-tab-span" style="white-space: pre;">    </span><br><span class="Apple-tab-span" style="white-space: pre;">        </span><br>Use Edit to provide a facility for making changes to an object the<span class="Apple-converted-space"> </span><br>user selects.<span class="Apple-converted-space"> </span><br>Not recommended:<span class="Apple-converted-space"> </span><br><br><br>  *<span class="Apple-converted-space"> </span><br>Modify<span class="Apple-converted-space"> </span><br><br>  *<span class="Apple-converted-space"> </span><br>Change<span class="Apple-converted-space"> </span><br><br><br>Modify<span class="Apple-converted-space"> </span><br><span class="Apple-tab-span" style="white-space: pre;">   </span><br>Not recommended. See Edit<span class="Apple-converted-space"> </span><br><br>New<span class="Apple-converted-space"> </span><br><span class="Apple-tab-span" style="white-space: pre;">        </span><br>Not recommended. See either Add or Create<span class="Apple-converted-space"> </span><br><br>Remove<span class="Apple-converted-space"> </span><br><span class="Apple-tab-span" style="white-space: pre;">     </span><br>Remove an item from a list, group, view, or other container element without deleting the item<span class="Apple-converted-space"> </span><br>Also see Add and Delete.<span class="Apple-converted-space"> </span><br><br><span class="Apple-tab-span" style="white-space: pre;">       </span><br><span class="Apple-tab-span" style="white-space: pre;">        </span><br>Complement of Add.<span class="Apple-converted-space"> </span><br>If what you are removing is not readily apparent from the<span class="Apple-converted-space"> </span><br>context, consider adding a noun to the button label (for<span class="Apple-converted-space"> </span><br>example, Remove File, Remove User).<span class="Apple-converted-space"> </span><br><br>Abbreviations for Days<span class="Apple-converted-space"> </span><br>In sentences, do not abbreviate days. Abbreviate them only when space is limited, as in tables or graphics. When you must abbreviate them, use the following abbreviations:<span class="Apple-converted-space"> </span><br><br>Sun<span class="Apple-converted-space"> </span><br><span class="Apple-tab-span" style="white-space: pre;">   </span><br>Sunday<span class="Apple-converted-space"> </span><br><br>Mon<span class="Apple-converted-space"> </span><br><span class="Apple-tab-span" style="white-space: pre;">   </span><br>Monday<span class="Apple-converted-space"> </span><br><br>Tue<span class="Apple-converted-space"> </span><br><span class="Apple-tab-span" style="white-space: pre;">   </span><br>Tuesday<span class="Apple-converted-space"> </span><br><br>Wed<span class="Apple-converted-space"> </span><br><span class="Apple-tab-span" style="white-space: pre;">  </span><br>Wednesday<span class="Apple-converted-space"> </span><br><br>Thu<span class="Apple-converted-space"> </span><br><span class="Apple-tab-span" style="white-space: pre;">        </span><br>Thursday<span class="Apple-converted-space"> </span><br><br>Fri<span class="Apple-converted-space"> </span><br><span class="Apple-tab-span" style="white-space: pre;"> </span><br>Friday<span class="Apple-converted-space"> </span><br><br>Sat<span class="Apple-converted-space"> </span><br><span class="Apple-tab-span" style="white-space: pre;">   </span><br>Saturday<span class="Apple-converted-space"> </span><br><br>Abbreviations for Months<span class="Apple-converted-space"> </span><br>In sentences, do not abbreviate months. Abbreviate them only when space is limited, as in tables or graphics. When you must abbreviate them, use the following abbreviations:<span class="Apple-converted-space"> </span><br><br>Jan<span class="Apple-converted-space"> </span><br><span class="Apple-tab-span" style="white-space: pre;">        </span><br>January<span class="Apple-converted-space"> </span><br><br>Feb<span class="Apple-converted-space"> </span><br><span class="Apple-tab-span" style="white-space: pre;">  </span><br>February<span class="Apple-converted-space"> </span><br><br>Mar<span class="Apple-converted-space"> </span><br><span class="Apple-tab-span" style="white-space: pre;"> </span><br>March<span class="Apple-converted-space"> </span><br><br>Apr<span class="Apple-converted-space"> </span><br><span class="Apple-tab-span" style="white-space: pre;">    </span><br>April<span class="Apple-converted-space"> </span><br><br>May<span class="Apple-converted-space"> </span><br><span class="Apple-tab-span" style="white-space: pre;">    </span><br>May<span class="Apple-converted-space"> </span><br><br>Jun<span class="Apple-converted-space"> </span><br><span class="Apple-tab-span" style="white-space: pre;">      </span><br>June<span class="Apple-converted-space"> </span><br><br>Jul<span class="Apple-converted-space"> </span><br><span class="Apple-tab-span" style="white-space: pre;">     </span><br>July<span class="Apple-converted-space"> </span><br><br>Aug<span class="Apple-converted-space"> </span><br><span class="Apple-tab-span" style="white-space: pre;">     </span><br>August<span class="Apple-converted-space"> </span><br><br>Sep<span class="Apple-converted-space"> </span><br><span class="Apple-tab-span" style="white-space: pre;">   </span><br>September<span class="Apple-converted-space"> </span><br><br>Oct<span class="Apple-converted-space"> </span><br><span class="Apple-tab-span" style="white-space: pre;">        </span><br>October<span class="Apple-converted-space"> </span><br><br>Nov<span class="Apple-converted-space"> </span><br><span class="Apple-tab-span" style="white-space: pre;">  </span><br>November<span class="Apple-converted-space"> </span><br><br>Dec<span class="Apple-converted-space"> </span><br><span class="Apple-tab-span" style="white-space: pre;"> </span><br>December<span class="Apple-converted-space"> </span><br><br>Abbreviations for Units of Time<span class="Apple-converted-space"> </span><br>In sentences, do not abbreviate these units of time: seconds, minutes, hours, days, months, and years. Abbreviate them only when space is limited, as in tables or graphics. When you must abbreviate them, use the following abbreviations for both the singular and plural forms:<span class="Apple-converted-space"> </span><br><br>sec<span class="Apple-converted-space"> </span><br><span class="Apple-tab-span" style="white-space: pre;">   </span><br>Seconds<span class="Apple-converted-space"> </span><br><br>min<span class="Apple-converted-space"> </span><br><span class="Apple-tab-span" style="white-space: pre;">  </span><br>Minutes<span class="Apple-converted-space"> </span><br><br>hr<span class="Apple-converted-space"> </span><br><span class="Apple-tab-span" style="white-space: pre;">   </span><br>Hours<span class="Apple-converted-space"> </span><br><br>d<span class="Apple-converted-space"> </span><br><span class="Apple-tab-span" style="white-space: pre;">      </span><br>Days<span class="Apple-converted-space"> </span><br><br>mo<span class="Apple-converted-space"> </span><br><span class="Apple-tab-span" style="white-space: pre;">      </span><br>Months<span class="Apple-converted-space"> </span><br><br>yr<span class="Apple-converted-space"> </span><br><span class="Apple-tab-span" style="white-space: pre;">    </span><br>Years<span class="Apple-converted-space"> </span><br><br>qtr<span class="Apple-converted-space"> </span><br><span class="Apple-tab-span" style="white-space: pre;">    </span><br>Quarter<span class="Apple-converted-space"> </span><br><br>Q1<span class="Apple-converted-space"> </span><br><span class="Apple-tab-span" style="white-space: pre;">   </span><br>First Quarter<span class="Apple-converted-space"> </span><br><br>Q2<span class="Apple-converted-space"> </span><br><span class="Apple-tab-span" style="white-space: pre;">     </span><br>Second Quarter<span class="Apple-converted-space"> </span><br><br>Q3<span class="Apple-converted-space"> </span><br><span class="Apple-tab-span" style="white-space: pre;">    </span><br>Third Quarter<span class="Apple-converted-space"> </span><br><br>Q4<span class="Apple-converted-space"> </span><br><span class="Apple-tab-span" style="white-space: pre;">     </span><br>Fourth Quarter<span class="Apple-converted-space"> </span><br><br>Truncation<span class="Apple-converted-space"> </span><br>Instances where text might need to be truncated:<span class="Apple-converted-space"> </span><br><br><br>  *<span class="Apple-converted-space"> </span><br>Page titles that show object/host names<span class="Apple-converted-space"> </span><br><br>  *<span class="Apple-converted-space"> </span><br>Table cells that contain long strings or lots of data and that have some method to view the full text<span class="Apple-converted-space"> </span><br><br>  *<span class="Apple-converted-space"> </span><br>Others?<span class="Apple-converted-space"> </span><br><br><br>Avoid abbreviations or truncated text in navigation items (first, second, and third levels of navigation in the masthead; left navigation).<span class="Apple-converted-space"> </span><br><br>In column headings, if there is not sufficient room for the full spelling or hyphenation of a word, abbreviate the text according to the English abbreviation rules [actually, should be according to our rules too]. Do not truncate text in column headings.<span class="Apple-converted-space"> </span><br><br>Whether to design for truncating strings at the beginning, end, or in the middle requires a bit of research.<span class="Apple-converted-space"> </span><br><br><br>  1.<span class="Apple-converted-space"> </span><br>Does the product have a default truncation scheme? (For example, CloudForms, which has a default setting for how to truncate host names but also a user preference if users want to change it to suit their naming scheme.) If yes, follow that scheme along with the guidelines here.<span class="Apple-converted-space"> </span><br><br>  2.<span class="Apple-converted-space"> </span><br>If the product doesn't have a default truncation choice, think about how the product's users are apt to name objects -- is it more likely that the unique part of the name will be at the beginning or end of the string?<span class="Apple-converted-space"> </span><br><br><br>Guidelines:<span class="Apple-converted-space"> </span><br><br><br>  *<span class="Apple-converted-space"> </span><br>Indicate truncated text with an ellipsis (…). If the text is part of a link, the ellipsis should be part of the link as well.<span class="Apple-converted-space"> </span><br><br>  *<span class="Apple-converted-space"> </span><br>Leave no fewer than 4 characters when truncating text, and preferably leave enough characters to give a fair idea of what the string says. For example, don't truncate demo1.internal-el6.satellite to de...<span class="Apple-converted-space"> </span><br><br>  *<span class="Apple-converted-space"> </span><br>Ensure that there is at least one method for the user to view the entire string. Options include: tooltips (useful for less than 150 characters or so), expanding rows, overlays, others?<span class="Apple-converted-space"> </span><br><br>  *<span class="Apple-converted-space"> </span><br>For UI text (as opposed to user-generated text), ensure that the truncation does not make an awkward word (i.e. "associate" truncating to "ass...")<span class="Apple-converted-space"> </span><br><br>  *<span class="Apple-converted-space"> </span><br>If possible, ensure that truncation does not happen after punctuation, because then it is difficult to differentiate which is the ellipsis and which is part of the name. For example, don't truncate demo1.internal-el6.satellite to demo1….<span class="Apple-converted-space"> </span><br><br>  *<span class="Apple-converted-space"> </span><br>If a table column is resizable, the truncated text should adjust accordingly, and continue to follow the preceding guidelines.<span class="Apple-converted-space"> </span><br><br><br><br><br><br>_______________________________________________<br>Patternfly mailing list<br><a href="mailto:Patternfly@redhat.com">Patternfly@redhat.com</a><br>https://www.redhat.com/mailman/listinfo/patternfly<br></blockquote><br><br>_______________________________________________<br>Patternfly mailing list<br><a href="mailto:Patternfly@redhat.com">Patternfly@redhat.com</a><br><a href="https://www.redhat.com/mailman/listinfo/patternfly">https://www.redhat.com/mailman/listinfo/patternfly</a></div></blockquote></div><br></body></html>