Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

Punctuation guidelines

Updated on January 21, 2021

Ensure that you use punctuation correctly to create clear and unambiguous documentation.

  • Using capitalization

    To help user understand and identify the features that you describe, make capitalization consistent in all the texts that you create.

  • Grammar guidelines

    To create clear, consistent documentation that is understandable by all users, ensure that you adhere to the following grammar guidelines:

  • Commas

    Use a comma to separate elements in a sentence, such as items in a series, introductory phrases, or clauses. Apply the following specific rules for correct comma usage.

  • Hyphens and dashes

    Follow our style guidance to learn when to use hyphens in compounds and, in very specific cases, with prefixes, and when to apply en dashes in ranges. Do not use em dashes if you can replace them with other punctuation marks, such as commas, semicolons, or dedicated DITA elements (such as the dl tag).

  • Slashes

    The slash is a punctuation mark that is most often used to represent the conjunction and, or the inclusive form of or. It is also used in mathematics to show fractions and division, in computing to separate the parts of a URL, and in some languages as a date separator.

  • Parentheses

    There are four kinds of bracket: round, curly, angle, and square. Parentheses are what we properly call round brackets.

  • Quotation marks and apostrophes

    As with the use of punctuation to create decimal points in numbers, the use of quotation marks and apostrophes can vary significantly from language to language. In our work as writers and editors at Pega, there are only a few short rules for their correct usage.

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us