ROADYOM
EN
Get started

Plain Arabic for the Second-Day Intern

We switched our interface from colloquial to Modern Standard Arabic — and found that plain language is a form of respect.

Ibrahim Elkobeissi · · 4 min read ·

A person reviewing a training screen in a quiet room, afternoon light from a window

The wrong dialect for most people

When we first wrote the Arabic interface for our tools, we used colloquial text. It felt warm, approachable. The kind of language a person uses with colleagues, not the kind they read in a government document.

We were wrong in two ways.

First, colloquial Arabic is not one language. Lebanese colloquial is Lebanese. It carries signals that mark it as belonging to a specific geography, a specific social register, a specific set of people. A coordinator in a hospital in Riyadh reads it differently than a trainer in Amman. The warmth we intended carried a geography we did not intend.

Second, colloquial text in a professional context can read as unclear, not warm. When a coordinator opens a tool at work, she is not looking for the feeling of a text message from a friend. She is looking for a clear instruction. "أرسل" is immediately understood. "بعّت" is familiar to some and foreign to others, and in a task flow, foreignness is friction.

The standard we chose

Simple Modern Standard Arabic. Not the Arabic of a legal contract or a newspaper editorial. The Arabic a day-two intern understands without asking.

That phrase — a day-two intern — is the test. If a coordinator who started yesterday and is reading the interface for the first time can follow it without help, the language is working. If she needs to ask a colleague what a word means, the language has failed before the feature has had a chance to.

Simple MSA has a grammar. Short sentences. Active verbs at the front. Numbers in Western Arabic numerals (0–9), which is what the Journal already uses and what people read faster in an interface. Product names in English, because Reflection and Prism are names, not descriptions, and transliterating them into Arabic adds noise. Everything else in MSA.

What we removed

Switching to plain MSA required removing things, not adding them. Here is what came out.

Register markers. Words that signal a formal institutional tone — "يُرجى التكرّم بـ", "نحيطكم علمًا" — went. They are not wrong. They are the language of a printed form, and a task flow in a digital tool is not a printed form.

Filler connectives. "وبالتالي", "من ناحية أخرى", "تجدر الإشارة إلى". Each one adds weight without adding meaning. Remove them, and what remains is what the sentence actually says.

Nominalizations over verbs. "قم بإجراء المراجعة" became "راجع". "أرسل طلبًا" became "أرسل". The MSA rule is the same as the English rule: prefer the verb to the noun built from it.

Ambiguous colloquial. Any word that a Jordanian coordinator, an Egyptian trainer and a Saudi hospital manager might each interpret slightly differently was replaced with the MSA word all three know.

What we kept

Warmth is not colloquial. It is tone. Plain MSA can be direct and human at the same time.

"تم الحفظ" is correct. "تمّ الحفظ بنجاح" is a small reassurance that costs nothing. We kept it. The difference between a cold interface and a human one is often that one sentence where the tool acknowledges that the person did something and it worked.

Punctuation in the Arabic Journal style: the Arabic comma «،», the semicolon «؛», the question mark «؟». Not the Latin equivalents. The characters themselves are part of the language.

The rule, in one sentence

Write as if the reader is intelligent, busy and from anywhere in the Arabic-speaking world.

That sentence rules out condescension (write for intelligence), rules out filler (write for the busy person), and rules out dialect (write for the region). It does not rule out clarity, warmth or precision. Those are not in tension with plain language. They are what plain language makes possible.

Every screen in Reflection and Prism follows this rule. The coordinator who opens Reflection on her first shift and the manager who reviews a team summary in Prism are both reading plain MSA — the same standard, the same register, the same assumption that the reader does not need the interface to explain itself. See the standard in practice on our page for hospitals and medical centres.

Sources

  1. Politics and the English Language. Horizon, 1946.
  2. The Arabic AI Fingerprint: Corpus-Level Evidence for LLM-Generated Text. arXiv, 2025.
  3. Plain Language: A Handbook for Writers in the Public Service. Government of Canada, 2020.

Comments

    Comments appear after our team reads them. Please do not include patients' or colleagues' personal details.

    Built into ROADYOM Prism

    Learn more