Write notes

Who can do this

Any member with the User role can create notes by asking Ronja in an exploration. In a shared feature, new notes and note edits from non-admins wait for review by a Data Admin before going live (a brand-new note in a workspace-scoped feature can also be approved by a workspace admin).

A note is a document that lives inside a feature and teaches Ronja. There are two kinds:

• Skill notes teach Ronja a task — a runnable procedure, like how you build the weekly revenue report.
• Knowledge notes record reference information about that feature’s data — how a table behaves, how a metric is actually calculated, data caveats.

There is no “New note” button anywhere in Ronja — like most resources, notes are agent-authored: you describe what to save, and Ronja writes the note. (For how notes fit with the other learning surfaces, see How Ronja learns.)

Save a note

1. Open an exploration in the feature the note belongs to.
2. Ask Ronja to write it down — for example: “Save how we build the weekly revenue report as a skill.”
3. Wait for Ronja to create the note and open it beside the chat, marked with a violet NOTE badge.

Ronja opens the new note in a side panel so you can review it without leaving the conversation.

4. Read the note in the side panel. To refine a passage, highlight the text and click Add to chat, then tell Ronja what to change.
5. Click Open note in new tab to see the full note page — the body sits under Instructions, with version history and actions in the sidebar.

Ronja picks the kind (skill or knowledge) from what you’re saving, and writes the note’s description as a retrieval hint — a short “when should I load this?” line. In future conversations in this feature, Ronja checks these hints and loads the full note before starting related work. You’ll find your notes later in the feature page’s Skills and Knowledge lanes.

Tip

A good note pays for itself. Once Ronja has the procedure or fact written down, she loads it instead of re-deriving the same thing from scratch in every future conversation.

Scope: personal or shared

A note follows its feature’s scope:

• In a private feature, the note carries a “Personal” chip and your changes go live immediately.
• In a shared feature (a “Shared” chip), changes are staged and reviewed — see below.

Drafts on shared notes

Editing a shared note as a non-admin never touches the live version — the draft → submit → commit model is covered in full in Versions, drafts, and approvals. The note-specific steps:

1. Ask Ronja for the change. Your edit becomes a personal draft — admins can’t see it yet.
2. Ask Ronja to submit the draft when you’re happy with it. Its status flips to Review requested.
3. Wait for an admin to review and commit or reject it from the Inbox. The note stays on its current version until the commit — if the note is open beside a chat in the meantime, its header shows “new version waiting for approval”.

Creating a brand-new note in a shared feature is staged the same way: it’s submitted for approval as a proposal. Admins skip the queue — their shared-note edits go live as soon as they approve Ronja’s action in the chat.