Skip to main content

Writing content

Write the training body either by drafting it with AI from your sources, or by writing it yourself in the rich editor. This is the second step of the authoring flow. Whatever you start with, the body stays fully editable afterward.

Who this is for

Administrators (Quality Admin, HR Admin, Corporate Admin). AI drafting is restricted to administrators.

Choose how to create the content​

When the body is empty, the step asks how you want to start:

  • Use a controlled document - the official document itself is the training content. The learner reads it verbatim; you do not write or generate a body. This is the recommended path for work-instruction and SOP training.
  • Generate with AI from sources - AI drafts the content section by section, anchored to the documents you selected. This needs at least one attached source.
  • Write manually - start from a blank canvas and write in the editor.
Screenshot pendingContent step choice between using a controlled document, generating with AI, and writing manually
The AI option needs a source

The Generate with AI card is disabled until you have attached a source in the Sources step. The card explains why.

Anchor the training to a controlled document​

When you choose Use a controlled document, the verbatim document becomes the training body:

  • Pick which attached controlled document is the content. The learner reads it exactly as approved - the document is never copied into the training, it stays the official, pinned version, so the training always reflects what was approved.
  • Optionally add a short introduction and recap with the rich editor (or Generate with AI to draft them from the document). These accompany the document as a learning aid - they are clearly subordinate to it and never replace it.
  • The learner sees the document, its code, version and effective date, and can switch between the readable text and the original page images.

Because the body is the official document, you do not write or edit it here; you only add the optional intro and recap.

Draft with AI​

AI drafting is a two-stage path: first an outline, then per-section generation.

1. Outline​

The AI proposes an editable outline of sections from your sources. You can:

  • Edit each section's title and summary.
  • Reorder sections (move up or down) and remove them.
  • Add sections, up to the allowed maximum.
  • Refine the outline with a free-text instruction, which re-runs the outline.

When the outline is valid, proceed to generation.

Screenshot pendingEditable AI outline with reorder, add, and refine controls

2. Generate section by section​

The AI then writes each section one at a time. You can:

  • Start all to generate every section in sequence, or generate sections individually.
  • Regenerate a section. Already-written sections are passed to the model as context so the new section fits.
  • Refine the last-generated section with an instruction.
  • Cancel an in-flight generation at any time. A cancelled request is a quiet no-op.

A counter shows how many sections are generated. If the model produces a citation that points outside the sources you passed, the system strips it and shows a hallucinated citations warning with a count.

Screenshot pendingPer-section generation with progress counter and per-section regenerate

When all sections are generated, choose Use this content to assemble them into the editable body.

Edit in the rich editor​

However you started, the body lands in the rich editor, which is the canonical content. The editor formats and pastes through the same safe allowlist the learner viewer uses, so what you save is what the learner sees. You can keep editing freely.

To continue to the Assessment step, the body must not be empty.

Translating existing content​

For an existing training, use Translate with AI from the Training Library card menu. The system translates the current approved version into your selected app language and opens it here as editable content. This works for both normal authored content and document-anchored trainings; for document-anchored trainings, the official document body is included in the translation draft.

Treat the result as a draft: read it, adjust wording, confirm the quiz still matches the translated material, and submit for review. Translation does not bypass segregation of duties, and learners do not see it until an approver activates the new version.

Regenerating over manual edits​

If you ask to Regenerate with AI while the editor already has content, you are warned first and must confirm. This prevents silently discarding edits you made by hand.

Provenance, not inline markers​

The AI may use [Source N] markers internally while drafting, but the assembled training body contains no inline citation markers. Those markers reference the AI's retrieval order, not the documents attached to the version, so leaving them in would mislead the reader.

Instead, provenance is recorded as the sources attached to the version and shown to the learner in the training's sources banner.

Nothing is saved yet

Generating and editing content only changes your local draft. No training version is written until you submit on the Review step. See Compliance and audit-readiness.