The content of the Basics section is a collection of resources provided mostly by other groups in SAP. It has been shortened or specified for the needs of SAP BTP user assistance. Every section contains links to its source, mainly to the SAP Style Guide for Technical Communication.

Tone of Voice.png

Tone of Voice

  • Follow the CIAO principle (clear, insightful, approachable, and optimistic) in your communications.
  • Understand your target group's perspective and follow the principles of the people-centric approach (PCA).

Terms and Names.png

Terms and Names

  • Use consistent terminology and follow the official processes for terminology.
  • Use official product names and follow the official naming process when requesting new product names.
  • Handle country/region-specific terms with care.

Bias-Free Language.png

Bias-Free Language

  • Replace inappropriate terms.
  • Use gender-neutral language.
  • Use culturally neutral terms.

Language and Grammar.png

Language and Grammar

  • Write in U.S. English for a global audience.
  • Check your spelling.

Accessibility.png

Accessibility

  • Familiarize yourself with some basic accessibility principles for providing information.

Legal Aspects.png

Legal Aspects

  • Understand documentation as a legal concept.
  • Provide a feature scope description.
  • Familiarize yourself with the corporate task and product standard for user assistance.

Tools.png

Tools

  • Use the right tools to deliver user assistance.