← Emberlern/The Data Diaries With Dee
The Ticket That Doesn't Come Back / Module 06

The knowledge base

Five lessons, about an hour. A brand's knowledge base is where the answer to the fortieth "does this ship to Kenya" question should already live, written once and well, rather than reinvented every shift. This module is about building and keeping that document honest — because module 7's AI chatbot is only as good as what it's trained on.

Module 6 worksheets A repeated-question log, a help-centre audit checklist, an article template, a sync-tracking sheet, and a pattern-reporting template. One .docx, five pages.
Lesson 6.112 minutes

Turning a repeated question into a documented answer with a stopping point

The fifth time you type essentially the same answer to essentially the same question, that's the signal — not a coincidence, a document that doesn't exist yet. Waiting for a "good moment" to write it down means answering it a sixth, seventh and twentieth time by hand.

If you've answered it three times this week, it belongs in the knowledge base, not in your memory.

What "documented" actually means

Not a rough note to yourself — a version another rep, or a customer directly, could read cold and understand. Written with a stopping point: the article answers the question fully and then stops, rather than trailing into every edge case that could theoretically come up, which is how help-centre articles become unreadable walls of text nobody finishes.

Worked example: from repeated answer to documented one

Shipping to Kenya, asked five times this month

"Yes! We ship to Kenya via DHL, typically 8–12 working days, and duties are included in the checkout price so there's nothing extra on delivery." — turned into a help-centre article titled "Do you ship to Kenya?" with exactly that answer, so it's now a link, not a retype.

Keep this
  • Three times asked this week is the signal to document, not a coincidence to shrug off.
  • Write for someone reading cold, with a clear stopping point.
  • A documented answer becomes a link you send, not a paragraph you retype.
Do this now — 6 minutes

Think of a question you've personally answered more than once recently, anywhere. Write the documented version, with a clear stopping point.

Lesson 6.213 minutes

Auditing a help centre for what's outdated, missing, or wrong

A help centre nobody has audited in months quietly accumulates a specific kind of danger: articles that were correct when written and are now wrong, because the policy behind them changed and nobody updated the page. A customer who reads an outdated return window and is then declined trusts the brand less than one who never found an article at all.

The three questions for every article, once a quarter at minimum

Is this still factually correct against current policy? Is anything the brand now offers or does missing entirely? And — the one most audits skip — does this article actually match what reps are saying in real tickets, or has practice quietly drifted from what's written?

An audit catching real drift

Help-centre article: "Returns accepted within 30 days." Actual current practice, found across recent tickets: reps have been quietly extending to 35 days for repeat customers without anyone documenting it as policy. The article isn't wrong exactly — it's just no longer what's actually happening, which is its own kind of problem.

Keep this
  • Audit against current policy, not against memory of what the policy used to be.
  • Check for what's missing, not just what's wrong.
  • Compare the written article against actual recent tickets — practice drifts quietly from documentation.
Do this now — 8 minutes

Pick any real, publicly available help-centre article. Check it against the three questions and note anything that fails.

Lesson 6.313 minutes

Writing an article a stressed customer can actually follow

Nobody reads a help-centre article for fun. They arrive because something's wrong and they want it fixed, often mid-frustration — which means an article written like a calm reference manual, full of caveats and subclauses, fails the actual reader even when every word in it is accurate.

The shape that works under stress

Lead with the direct answer in the first line. Follow with the steps, numbered, one action per line. Put exceptions and edge cases at the end, clearly separated, for the smaller number of readers who need them — not woven through the main answer where they slow everyone else down.

Same article, buried versus stress-readable
Buried in caveats

"Returns are generally accepted within a window of time, though this can vary depending on the item purchased and whether it was part of a promotional sale, and customers should be aware that certain conditions may apply before initiating..."

Stress-readable

"You can return most items within 30 days of delivery. 1) Email us your order number. 2) We'll send a return label. 3) Refund lands in 3–5 days once received. Sale items are final — see exceptions below."

Keep this
  • Lead with the direct answer, not a preamble.
  • Numbered steps, one action per line.
  • Exceptions go at the end, separated — not woven through the main path.
Do this now — 7 minutes

Rewrite a caveat-heavy paragraph — real or made up — into the stress-readable shape.

Lesson 6.411 minutes

Keeping macros and docs in sync as policy changes

A macro and a help-centre article answering the same question are two copies of the same fact, and two copies drift apart the moment one gets updated and the other doesn't. A customer who reads the help centre and gets a different answer from a macro-based reply notices immediately, and it reads as the brand not knowing its own policy.

The habit that prevents drift

Whenever a policy changes, update the source article first, then treat every macro referencing that fact as needing a check — not an assumption it's still fine. A short running list of "what references this policy" for anything genuinely load-bearing (a return window, a shipping zone) makes this a five-minute task instead of a search-and-hope.

This is exactly what module 7 will ask you to check in an AI chatbot too

A chatbot trained on an outdated help centre will confidently repeat the outdated answer. Keeping the source documents current isn't just a tidiness habit — it's what module 7's chatbot supervision depends on.

Keep this
  • A macro and an article stating the same fact are two copies that will drift apart if only one gets updated.
  • Update the source article first, then check everything referencing it.
  • Keep a short list of what references each load-bearing policy fact.
Do this now — 5 minutes

List three places (macros, articles, a pinned message) that would need updating if your brand's return window changed tomorrow.

Lesson 6.511 minutes

Reporting the pattern back: when five tickets are actually one product problem

Documenting an answer well solves the support side of a repeated question. It doesn't solve the underlying cause if the repeated question is actually a symptom — five broken-pump complaints this month isn't a knowledge-base gap, it's a supplier problem that a founder needs to know about, and support is often the first place the pattern becomes visible at all.

What makes a pattern worth escalating rather than just documenting

Frequency rising rather than flat, a shared specific cause rather than five unrelated complaints that happen to look similar, and a cost to the business beyond support time — refunds, lost customers, reputational risk. A pattern report names the specific tickets, the shared thread, and a plain recommendation, not just a vague "we're getting a lot of complaints about this."

A pattern report, not just a vent

"Flagging: three broken-pump complaints this month (orders #2288, #2299, #2311), all the same 250ml rose clay line, all reported within days of arrival — that's up from zero last month. Recommend checking with the supplier on this specific batch before more ship."

Keep this
  • Rising frequency, a shared cause, and a real business cost are what make a pattern worth escalating.
  • Name the specific tickets, not a vague sense of "a lot of complaints."
  • End with a plain recommendation — a pattern report without one is just a complaint about complaints.
Do this now — 6 minutes

Write a pattern report for three related complaints, real or made up, using the worked example's shape.

Module 6 drillone hour

An outdated help centre

Bumi Naturals' help centre is supplied, along with its current actual policy and a batch of recent tickets. The return-policy article is stale, two articles are missing entirely, and one macro contradicts what the help centre says.

Deliver four things

  1. An audit — every article checked against 6.2's three questions, with a pass/fail note on each.
  2. Three rewritten articles — the stale one corrected, and two new ones for genuine gaps you find, all in 6.3's stress-readable shape.
  3. A sync note — every macro or other reference that needs updating alongside the corrected article, per 6.4.
  4. A pattern flag — one thing in the tickets worth escalating to the founder, in 6.5's report shape.

How it is marked

  • Did the audit catch the actual drift? Not whether every possible issue was found, but whether the real, planted ones were.
  • Are the rewritten articles genuinely stress-readable? Direct answer first, numbered steps, exceptions at the end.
  • Is the pattern flag specific, with named tickets and a recommendation? A vague flag fails even if the underlying instinct was right.
What this drill is really testing

Whether you can treat a knowledge base as a living document that needs maintenance, not a one-time writing task — the same discipline that keeps a brand's self-service answers actually trustworthy.

Before module 7

You should now have: a habit of documenting repeated questions, an audit method, a stress-readable article shape, a sync-tracking habit, and a pattern-report template. Module 7 turns to handing this knowledge base to an AI chatbot as your junior — and catching it when it invents an answer the documents never actually gave it.