ellipses

✍️ google-blog-style

Source: https://developers.google.com/style/ellipses\n\n# Ellipses

Stay organized with collections

Save and categorize content based on your preferences.\n\n- Home\n- Products\n- Style\n\n\n## Page Summary\n\n- Avoid using ellipses (...) in technical documentation to indicate omission or hesitation.\n- When describing UI elements, omit ellipses unless their absence would create confusion.\n- In quoted text, ellipses can be used to replace omitted content mid-sentence, but not at the beginning or end.\n- Ellipses should be three periods with a space before and after, unless followed by punctuation.\n\nAvoid using ellipses (...) in technical documentation to indicate omission or hesitation.\n\nWhen describing UI elements, omit ellipses unless their absence would create confusion.\n\nIn quoted text, ellipses can be used to replace omitted content mid-sentence, but not at the beginning or end.\n\nEllipses should be three periods with a space before and after, unless followed by punctuation.\n\nIn general, don't use ellipses. An ellipsis is made up of

three contiguous periods. Ellipses indicate the omission of part of a sentence, paragraph, or larger

block of text where the omission is not pertinent to the understanding of the subject at

hand.\n\n\n## Ellipses as suspension points\n\nWhen ellipses are used to indicate hesitation, they are called suspension

points. Don't use ellipses this way in our documentation.\n\nNot recommended: The answer is ... wait

for it ... that you shouldn't do this.\n\n\n## Ellipses in a user interface\n\nWhen ellipses appear in a user interface, exclude them from the

documentation describing the user interface unless their omission could cause

confusion. For example, if the text on the button in the UI reads Save ...,

document it as click Save.\n\n\n## Ellipses in text\n\nDon't use ellipses in your written documentation; omit any unnecessary

information and include all necessary information.\n\nHowever, it's acceptable to use ellipses in quoted text (to replace a

portion of the quoted text) except when they appear at the beginning or end of

the text.\n\nNot recommended: My high school English

teacher made me learn that Shakespeare quote about all the world being a stage

and " ... all the men and women merely players."\n\nNot recommended: My high school English

teacher made me learn that Shakespeare quote: "All the world's a stage, And all

the men and women merely players ...."\n\nThe previous example ended with four ellipsis points. The final

ellipsis point is, in fact, a period. So when the material that you're omitting

contains one or more sentence boundaries, use four dots instead of three.\n\nRecommended: My high school English

teacher made me learn that Shakespeare quote: "All the world's a stage, ....

And one man in his time plays many parts."\n\n\n## Punctuation and spacing of ellipses\n\nKeep all three ellipsis points together. When creating an ellipsis,

instead of the ellipsis character, use three periods in a row. Insert one space

before and after the ellipsis unless a punctuation mark immediately follows the

ellipsis; in this case, don't insert a space after the ellipsis.\n\nRecommended: You don't need to

understand all the other Python code in there ... we'll explain it all in class.\n\nAlso recommended: You don't need to

understand all the other Python code in there ...; we'll explain it all in class.\n\nNot recommended: You don't need to

understand all the other Python code in there...we'll explain it all in class.\n