Skip to content

Capitalization

Shani Ranasinghe edited this page Dec 18, 2020 · 2 revisions

Titles of people

  • Capitalize a person’s title only when it’s used directly before a name.
    • Example.:
      • Sanjiva Weerawarana is the co-founder and chief executive officer at WSO
      • WSO2 Co-Founder and Chief Executive Officer Sanjiva Weerawarana

Titles of content

  • Main titles use uppercase for the first letter of all words.

    • Do not capitalize
      • Articles (a, an, and the)
      • Prepositions of three or fewer letters (of, in, and for)
      • Most conjunctions of three or fewer letters (as, and, or, and but)
      • The “to” in the infinitive form (e.g. to Write).
    • Example:
      • Deploy and Test Prototype APIs
      • Webinar: Why Does Modular Middleware Matter?
      • The Process of Mediators Within WSO2 ESB - The Mediator Catalog
  • Any other headings use sentence style (i.e., only the first word in uppercase).

    • Example:
      • Table of contents
  • Maintain branded lowercase proper nouns and other industry standards.

    • Example:
      • eBay
      • iPhone
      • PaaS
  • Hyphenated compounds in titles

    • Capitalize the first word, and capitalize all subsequent words in the compound except for
      • articles (a,an, and the).
      • prepositions of three or fewer letters (like to and of).
      • coordinating conjunctions (for, and, nor, but, or, yet, and so).

Ask yourself: If this word weren't in a hyphenated compound, would I capitalize it? If the answer is yes, capitalize it as part of the hyphenated compound, too. * Example:
* Platform-as-a-Service * On-Premises * Eclipse-Based * Cloud-Enabled

Company and product names

  • Follow an organization’s conventions as to how it capitalizes and punctuates its names.
  • When in doubt, look at some of the organization’s press releases or at its copyright page if it has one.
    • Example:
      • WSO2
      • WSO2 API Manager
      • eBay
      • MuleSoft
      • Apache Synapse
      • GitHub