Using the Knowledge Library

Read your account's brief, suggest edits and new facts right in the document, and, as an admin, review, publish, and roll back clean versions.

The Knowledge Library page is where Radiant lives as a document you can actually read and shape. Everything Upside knows about how your account buys, renews, and operates sits here as a brief, kept current by your team and the mining agent, and verified before it's published.

It reads like a document and works like a review queue. The left side is the brief itself. The right side is where changes are proposed, reviewed, and published as clean, numbered versions.


Start here: the three ideas

Almost everything on the page follows from three ideas. Get these and the rest is detail.

📄 It's a brief of facts

Knowledge is stored as short facts, grouped into topics. Everything you read in the brief is published: verified, trusted, and frozen.

✏️ Changes are proposals

Anyone can suggest an edit or a new fact. Proposals ride along in the document as tracked changes. They never touch the published brief on their own.

📦 Admins publish versions

An admin reviews proposals and publishes the approved ones together as a numbered version, which you can always roll back to.

💡

Two roles, one page. Members read the brief and propose changes. Admins do all of that, plus review, publish, and roll back. The page adapts to your role automatically; there's no toggle to flip.


What you're looking at

AreaWhat it is
MastheadThe document header: account name, current version, last-published date, and a count of changes awaiting review.
The documentThe left side. Topic sections and their published facts. Proposed changes appear inline as tracked changes.
Review railThe right side. Admins accept, reject, and publish here; members track their own suggestions.
History panelsPer-fact version history and the full library version history, with one-click rollback for admins.

The masthead is worth a second look, since it changes with your role. The Version N chip is a button for admins (it opens the full library history) and a plain label for members. The pending-changes line is worded for you too: "N changes awaiting review" for admins, "N suggestions of yours pending" for members.


How a change flows

Every change (an edit, a new fact, a new topic) travels the same path. Publishing is deliberate and batched, so each version is a coherent snapshot rather than a stream of one-off edits.

Not every proposal makes it to "published." All told, a proposal lands in one of five states:

Unverified: awaiting review

A suggestion someone submitted. It shows in the document as a tracked change and in the rail as a pending card. Members see only their own; admins see everyone's.

Verified: staged for the next version

An admin accepted it. It's queued to go live at the next publish. Admins can un-stage it back to pending before publishing.

Published: verified and frozen

Part of the live brief, tied to a numbered version. Published facts are frozen; changing one means proposing a new edit.

Rejected: terminal

An admin declined it with a reason the proposer can see. Rejection is final: the card leaves the rail and the tracked change disappears from the document. To revisit the idea, propose it anew.

Withdrawn: retracted by the proposer

A member pulled back their own pending suggestion before an admin reviewed it.


Working in the document

This is what everyone can do, member or admin. It all happens on the left side, right in the brief.

Reading a fact

Facts are grouped into topics, each with a heading, an optional description, and its published facts as short paragraphs. Facts with no topic collect under an Uncategorized section.

Under each fact, a quiet provenance line carries the details without cluttering the read:

  • a ✓ Verified marker,
  • who proposed it (a teammate, the mining agent, or the system),
  • the source citation, if one was given,
  • and, for admins, a version(s) chip that opens the fact's history plus a Remove control.

Suggesting an edit

Hover any fact and a ✎ Suggest an edit badge appears. Click it to open an inline editor pre-filled with the current text, make your change, and choose Suggest change. The label is deliberate: you're proposing, not overwriting. Your edit is tracked and routed to review.

💡

One suggestion per fact at a time. If a fact already has a pending suggestion, it shows in tracked-change mode and the inline editor won't open until that suggestion is resolved. Press ⌘↵ to save, Esc to cancel.

Adding a fact

At the bottom of every section is + Add a fact to [Topic]. Write the fact, add an optional source, and choose Propose fact. It stays pending until an admin reviews it.

Starting a new topic

Below the last section, Start a new topic opens a small composer for knowledge that doesn't fit the existing groups. Name the topic, add an optional description and a first fact, then Propose topic. Both the topic and its first fact enter review together.

Following your suggestions

Your own proposals appear in the right-hand rail under Your suggestions. Each card reads Awaiting admin review, with a Withdraw link to retract it before it's reviewed. Once an admin accepts it, the card shows it's approved and pending publish.

Spotting tracked changes

Pending changes render right in the document, so the brief and the review queue always tell the same story:

  • Edits to an existing fact show a word-level redline (removed words struck through in red, added words underlined in green) inside an amber-ruled block.
  • New facts appear as green-ruled blocks beneath a section's published facts, attributed to whoever proposed them.
  • Hovering a change in the document highlights its card in the rail, and vice versa. Click a tracked change to jump straight to its review card.

Reviewing and publishing

This is the admin's job, and it all happens in the Review changes rail on the right.

Accepting and rejecting

Every pending suggestion across the account lands in the rail as a card showing the proposer, the timing, the topic, whether it's a New fact or an Edit, and the proposed text (edits with an inline redline).

  • Accept stages a suggestion; Reject opens a dialog for a required reason the proposer will see.
  • Select all plus Accept N / Reject N handle a batch in one move.
  • Accepted items collect under Approved for the next version; Un-stage sends one back to pending.

Removing an outdated fact

Facts get outdated. On the provenance line, an admin can choose Remove to stage a published fact for deletion from the next version. The fact shows struck through, and the rail lists it under the facts to be removed. Keep in library un-stages it. Nothing actually leaves the brief until you publish.

Publishing a version

Publishing turns everything staged (accepted edits, new facts, and removals) into a single numbered version. It's the one moment changes go live, which keeps every version clean and reviewable.

🚧

Resolve conflicts before publishing. When two suggestions edit the same fact, each is flagged Needs resolution. Un-stage or reject all but one, then publish.


Version history and rollback

Per-fact history

The version(s) chip under a fact opens its Version history: every published revision, newest first, each superseding the one below. The current revision is badged Current. Admins get Restore this version, which proposes that older text as a new pending edit; it doesn't change the live brief directly.

Library version history

The masthead Version N chip (admin) opens Library version history: every published snapshot, newest first, with its publish date and note. Any non-active version offers Roll back to this version, which re-points the active library to that snapshot.

👍

Rollback is safe. Rolling back never deletes anything; it only changes which version is active, so you can always roll forward again. Version numbers follow publish order, so Version 1 is always the first one ever published.


Quick reference

Actions by role

ActionMemberAdmin
Read the published brief
Suggest an edit
Add a fact / start a topic
Withdraw your own suggestion
Accept / reject (single or batch)
Un-stage an approved change
Remove / keep a published fact
Publish a new version
View version history
Restore a fact version / roll back

Keyboard shortcuts

ShortcutWhat it does
⌘↵Save the current suggestion
EscCancel and close the editor

Did this page help you?