Nuvelics documentation
Web appSettings

Story checks

Write checks in your own words that run on stories and report what they find, then try, enable and archive them.

The Story checks tab holds the checks your newsroom runs on stories. Each check is a name, rules in your own words, and where it should run. Nuvelics evaluates it and reports what it finds: it never changes or withholds a story. The idea is explained in Templates, brand kits and checks.

Who can use it

Every role can open the tab (story_check:read) and see what checks run. Only owners and admins (story_check:manage) get New check, the row actions, the edit controls and the Try it panel; for everyone else the page is read-only.

Read the list

The list shows each check's Name, Output, Max severity, Channels, Model and Status, which is Enabled, Disabled or Archived.

Create a check

  1. Choose New check.
  2. Optional: choose Draft from a description, describe in one or two sentences (up to 500 characters) what the check should look for, and choose Draft the check. This fills in the whole form for you to review. It replaces what is on the form, nothing is saved until you create the check, and it is one call to the capable model charged to your spend, whether or not you keep the draft. Your editorial guidelines are included; no story text is read.
  3. Fill in the form:
    • Name: required.
    • Slug: kebab-case, meaning lowercase letters, digits and single hyphens, such as no-unsourced-figures. It becomes the rule id a downstream system keys on, so it is fixed once the check is created.
    • Instructions: the rules in your own words, up to 4000 characters, with a counter.
    • Output: Findings carry a severity a person can triage; Suggestions are proposals with no severity at all.
    • Max severity: for findings, Inform or Flag. It is the ceiling a finding is clamped to. A check never holds a story: it declares, people decide.
    • Channels: where the check runs, at least one. NRCS stories from Saga runs only on stories from newsroom connections whose Skills switch (Evaluate stories Saga delivers against the org's story checks) is on; with it off, nothing runs. SOM snapshots (when skills are on) runs on SOM snapshots.
    • Model: fast or capable. The form says fast is right for style and tone checks, and that capable costs roughly ten times more per story.
  4. Choose Create check.

You see Check created. A new check starts Disabled, so it costs nothing until you turn it on. Missing values are refused, for example Name is required, Instructions are required, Pick a max severity and Add at least one channel, and a slug that is not kebab-case gets "Slug must be kebab-case: lowercase letters, digits, and single hyphens between segments".

Try a check before you enable it

Open the check. In Try it, run the definition above against one of your stories or against pasted text before it costs money on every story. Nothing is recorded on the story.

  1. Choose the An NRCS story tab and pick a Story (only stories delivered to your organization can be tried), or the Pasted text tab and paste the Text. A Headline (optional) can go with it.
  2. Choose Run preview.

Enable or disable a check

  1. Open the check and choose Enable, or use Enable in the Story check actions menu.
  2. Read Enable this check? It runs on every matching story from now on and spends your organization's model budget on each one. Stories delivered before now are not evaluated. Confirm.

You see Check enabled. and the page says when it was enabled. Disable stops evaluating from now on, and findings already recorded are unaffected (Check disabled.).

Edit a check

  1. Open the check, change the Definition, and choose Save.

You see Check saved. Everything editorial can change except the slug. If another person saved first you are told "This check changed since you loaded it — reload and try again."

Archive a check

  1. From Story check actions or the check's page, choose Archive.
  2. Confirm Archive this check? It stops running and can no longer be edited; its past runs stay on record.

You see Check archived. An archived check can no longer run or be edited.

Other ways to manage checks

Report a problem with this page

On this page