Skip to content
Bablah

Handbook

Reviewing generated content

For reviewers and admins. Check translations and word meanings in your language, fix them, and see what is live.

Updated 19 November 2026

Who this is for

This guide is for reviewers and admins. A reviewer is someone trusted to check content in one or more languages. An admin can review every language and can manage people. Learners do not see the review area.

Why content needs review

The English text of Bablah is written by people. Translations into the other languages, and the meanings of the words in the catalogue, are generated first so that nobody waits for them. Each generated piece is marked Not reviewed until someone who knows the language has checked it.

Every piece of content has one of three states:

  • Not reviewed: generated, and nobody has checked it yet.
  • Reviewed: a reviewer approved it or wrote their own wording.
  • Out of date: the English it was made from has changed since.

Open the review area

Open the menu with your name and choose Review. The overview shows what is live and, for each of your languages, how much is waiting.

Work through the queue

  1. On the overview, choose Open queue beside a language.
  2. Choose the kind of content: App, Website, Handbook or Words and meanings.
  3. Choose Open beside an item. You see what it was made from and the generated content side by side.
  4. Do one of three things:
    • If it is right, choose Approve as it is.
    • If it is not, change the text and choose Save my wording. Saving also approves it.
    • If you are not sure, leave a comment for other reviewers.

Your change is live for every learner within a few seconds. There is nothing to deploy.

Things to check in a translation

  • Words inside %{...}, such as %{name}, are filled in by the app. Keep them exactly as they are.
  • Handbook guides are written in markdown. Keep the headings, lists and code blocks in place.
  • Prefer the words a native speaker would use in an app, even when they are not the literal translation.

History

Each item keeps its history: who changed it, when, and what it said before. Changes made by Bablah itself, such as a new generation after the English changed, appear as Bablah.

Manage people

Admins only. Choose People in the review area.

  • Set a person's role to Learner, Reviewer or Admin.
  • For a reviewer, tick the languages they review.

There must always be at least one admin.

See what is live

The overview shows the version of Bablah that is running and the commit it was built from, with a link to the build pipeline on GitHub.