Skip to content
footnote Docs
Install

Write context

What a context item is, what to put in it, and the line that stops an agent from reading a cause into it.

What a context item is

One thing agents should know about the numbers: an event, a warning, a rule or a guide. It has a source and a check date.

The four kinds

  • Event: Something that happened on a date, like a stop or a new rule.
  • Warning: A limit or problem agents should know, like late or missing data.
  • Rule: A fixed way to read the numbers, like a house rule.
  • Guide: What to check before you explain a change.

A new context item starts as an Event. Pick another kind under Kind when it is one.

What to put in it

The editor for a new context item, What should agents know?, with its properties: Domain Sales, Kind Event, Status Not published yet and the owners, then Applies to, When, Source and Don't conclude, and the text below them.The editor for a new context item, What should agents know?, with its properties: Domain Sales, Kind Event, Status Not published yet and the owners, then Applies to, When, Source and Don't conclude, and the text below them.
  1. A title that is one plain sentence, with its date.
  2. What agents should know: two or three sentences, with what it is not if people mix it up.
  3. Where and when it applies: the metrics and markets, and the dates.
  4. A source anyone can open. The check date is set for you.
  5. Don’t conclude: the one line that stops an agent from reading a cause into it.

In a domain you own, it is published at once. In another domain it goes to that domain’s owners as a suggestion: Review a suggestion is what they do with it. Applies to names only what Definitions lists.

An example

The demo’s item about the stop in Norway, owned by Sales, has every part. Here its dates leave out the year.

The context item Online sales to Norway stopped on 4 August 2026, as its page shows it: its text, the line it quotes from the customs notice, its domain, owners and when it was last checked, its source, and beside it what it links to and its history.The context item Online sales to Norway stopped on 4 August 2026, as its page shows it: its text, the line it quotes from the customs notice, its domain, owners and when it was last checked, its source, and beside it what it links to and its history.
PartIn the example
KindEvent
TitleOnline sales to Norway stopped on 4 August
What agents should knowA new customs rule stopped all online sales to Norway, so orders there fell to almost nothing. There are no stores in Norway, so the webshop was the only way to buy there.
Applies toOrders, Units sold and Gross sales, in Norway
WhenFrom 4 August, still going on
SourceA link to the customs notice, and the line copied from it, which says parcels from webshops outside Norway are held at the border
Check dateSet for you. Once it passes, the item is Due for a check.
Don’t concludeFewer orders in Norway after 4 August do not mean fewer customers.

The same news, written weakly:

PartIn the weak itemWhat is missing
TitleNorway is downWhat is down, what happened, and when
What agents should knowSales in Norway dropped a lotThe cause, and how to compare the weeks before and after it
Applies toNothingThe metrics and the market, so agents know which questions it answers
SourceNothingA link anyone can open, so an owner can check it
Don’t concludeNothingThe line that stops an agent from blaming the drop on customers

About our business

A short text every agent reads first, in Settings, General: what the business is, words that are easy to misread, and house rules for reading numbers. No figures or customer names.