Formatting

highly recommended following the guidelines for formatting is encouraged as it will improve the user experience punctuation ellipses ( ) action that require further decisions use ellipses at the end of the name of an action that requires further decisions to be made before completing the action this can refer to the name found in a menu, button, or tooltip for example, “print ” is an action, but it opens a dialog to confirm settings before the printing action takes place label truncations avoid this as much as possible by using more concise text if a text is too long for its space, an ellipses can be used to imply that there is additional text hidden this text should then be revealed through a tool tip common misuses any old dialog do not add ellipses to the text to open every dialog, just to actions that require more decisions to be made with a dialog to complete if the dialog is a “space” where many actions and decisions can be made, it does not require the ellipses managers, labs, and dialogs that apply styles do not need ellipses lingering thoughts don’t end a sentence with an ellipses it is not clear or friendly it makes us look uncertain about what we’re saying, which does not build trust between sentences same as above using ellipses between sentences gives a sense of uncertainty and that there is information missing not the vibe we want our users to pick up on! button label an ellipses should never be the only content on a button a label can include an ellipses in the case that it is an action requiring further decisions, but it should never be present without an actual text label (please note this does not refer to the vertical 3 dot icon, only to using the string “ ” as a label to a button ) plural / singular in cases where a noun could be plural or singular, use plural the user will be able to interpret which one applies do not use “(s)” to denote that it could be plural or singular this causes too much grammatical mixing and makes reading more work than it should be do you have other drawings open would you like to close them? don’t you have other drawing(s) open would you like to close them? numbering for cardinal numbers (quantity), spell out numbers one through nine for 10 and higher, use digits for ordinal numbers (order of things), spell first, second, & third from 4th on, use digits punctuation marks the punctuation marks rules only applies to the english language ampersands use "&" instead of "and" for button labels, titles, and short sentences this improves text scanning and helps users read truncated text more easily you may use "and" in longer texts such as paragraphs import & export measure & scale the reconfiguration tool can be used to manage product inventories & reconfigurations of complex facilities you can narrow down the available beam profile selection by setting a minimum and maximum beam depth profiles that fall outside the specified values will be excluded from the selection list to view all available beam profiles again, simply click the reset button hyphens & dashes hyphens are used to combine two words into one idea it is a short line with no space between the two words it is connecting for example user centered up to date one of a kind dashes are longer than a hyphen and are used to denote a break in thought – like this – and has a space on either side you may need these in longer paragraph text in pop up dialogs or help text quotation marks quotation marks should only be used when quoting another source they should not be used to denote tool names, call out other text, or otherwise suggest something about the text in quotes do one user said, “i love using cet because it saves a lot of time ” do to apply finishes, go to the scheme dialog don’t to apply finishes, go to the “scheme” dialog end marks in most cases, use a period to end a complete sentence in some rare cases, you can use an exclamation point in a celebratory tone! when should you use a question mark? only when you’re asking a question? yes do not use an end mark when writing an incomplete sentence a complete sentence has a subject and verb, and usually an object if you’re not sure your copy is a complete sentence or not, use online resources or ai chat tools to check or a grammar text book! colons & semi colons use colons at the end of texts that are leading into a list semi colons are hard to master, and are usually unnecessary in technical writing avoid them unless absolutely necessary, and if you are certain you are using it correctly commas use the oxford comma – use a comma before "and" at the end of a list of three or more items this makes lists much clearer when the last item in a list has an "and" do not use a comma before "&" do sara, curtis & audrey do the utility extensions most used by designers are home accessories, symbols library, and plants and flowers don’t sara, curtis, & audrey don't the utility extensions most used by designers are home accessories, symbols library and plants and flowers text formatting bold & italics use bold in paragraph text when referring to other ui elements, such as tool names, settings, or text basically, whatever text a user might see when they are looking for something else in cet do use the scheme painter to copy materials and properties from one product to another do uncheck enable realtime lights to improve performance in the 3d view use italics rarely, but you can sometimes use it to emphasize a word or phrase that is particularly essential do not use it to imply personal inflection or to signify tool names capitalization different components have standards for what should be in title case or sentence case to find which case to use, find the component in the design system follow the ap style guide standards for capitalization this includes two types of cases sentence case is where only the first letter and any proper nouns are capitalized proper nouns include names (like audrey) specific places (like arches national park) companies, brands, and products (like configura) sentence case applies to section header title, subsection title, product and tool button labels go to extension content docid\ k9e w3zzkehm38jtvqkyu to view where they are located within the toolbox title case capitalizes the first letter, as well as all major words but not any unimportant words title case applies to extension title go to extension header docid 329vj0pqzc4rwqu qmv3d to view where it is located within the toolbox check out the resource section in best practices for writing docid\ jcyuxee9i96hsoujrv fw for help with checking capitalization