1. Home
  2. Docs
  3. Style Guide
  4. General Writing Principle...
  5. Global Audience

Global Audience

As WriteTech Hub serves a global audience, our documentation must be accessible and relevant to users from different cultural and linguistic backgrounds. This requires careful consideration of language, examples, and references.

  1. Clear Language for Non-Native Speakers:
    Use clear and simple language that non-native English speakers easily understand. Avoid idiomatic expressions, colloquialisms, and slang that may not translate well across cultures.
  2. International Examples:
    When providing examples, choose ones that are globally relevant or easily understood, regardless of the user’s location. For example, instead of using culturally specific references, opt for universal scenarios or use fictional examples.
  3. Date and Time Formats:
    Use international date and time formats (e.g., ISO 8601) to avoid confusion. Specify the relevant time zone and consider the global context when mentioning dates.
  4. Units of Measurement:
    When relevant, Provide metric and imperial units or specify the units used. For example, “The file size is 10 MB (approx. 10.5 million bytes).”
  5. Localisation and Translation:
    Consider how the documentation might be translated into other languages. Write in a way that facilitates translation by avoiding complex sentence structures and culturally specific references.
  6. Currency and Payment Information:
    When mentioning prices or currency, clarify which currency is being referenced and consider including a conversion for major global currencies.