Notes from the team
Long-form writing on knowledge bases, wiki performance, and keyboard-first editing. Migration write-ups for teams leaving Confluence, Notion, and Obsidian. Opinion pieces from people who type for a living.
30 posts so far. New ones land most weeks.
-
Marketing Requirements Document: What an MRD Is and Isn't
A marketing requirements document defines why to build something, before the PRD defines what. Here's what goes in an MRD, MRD vs PRD, and when to skip it.
marketing requirements document · mrd vs prd · what is a marketing requirements document
Read the post → -
SharePoint Alternatives: How to Pick One Your Team Will Use
SharePoint alternatives ranked by what matters: speed, adoption, and whether you can migrate your content out. Here's how to pick one that actually sticks.
sharepoint alternatives · sharepoint alternative · confluence vs sharepoint
Read the post → -
PRD Meaning: What a Product Requirements Document Is For
PRD stands for Product Requirements Document. It's the spec that tells engineering what to build and why. Here's the definition, contents, and when to skip it.
prd meaning · product requirements document · what is a prd
Read the post → -
What Is an Intranet? Definition, Uses, and Modern Examples
An intranet is a private network inside a company that shares information among employees. Here's the definition, the modern shape, and where it fits in 2026.
what is intranet · intranet definition · intranet vs internet
Read the post → -
Knowledge Management: A Field Guide for Working Teams
Knowledge management is how teams capture, organise, and reuse what they know. Here's the discipline in plain English — types, process, where it lives.
knowledge management · what is knowledge management · knowledge management system
Read the post → -
MoSCoW Prioritization: A Field Guide for Product Teams
MoSCoW prioritization sorts requirements into four buckets: must, should, could, won't. Here's how to run it, where it fits, and where it lives between sprints.
moscow prioritization · moscow method · moscow framework
Read the post → -
How to write a bug report engineers can actually fix
How to write a bug report: the seven-section shape, bug vs support ticket, who triages, what not to include, and where the report lives between file and fix.
how to write a bug report · bug report format · bug report example
Read the post → -
How to write a PRD that ships instead of stalls
How to write a PRD: the seven-section shape, PRD vs spec vs design doc, who owns it through review, how short is short enough, and where the doc lives between sprints.
how to write a PRD · prd vs spec · prd structure
Read the post → -
How to write a case study customers will let you ship
How to write a case study: the seven-section shape, the interview questions, who owns it, where it lives, and how to keep it fresh as the customer grows.
how to write a case study · case study format · case study structure
Read the post → -
How to write a runbook your on-call will actually use
How to write a runbook: the seven-section shape, runbook vs playbook, writing for 04:00, where the doc lives, and how to notice it's gone stale before it fails.
how to write a runbook · what is a runbook · runbook vs playbook
Read the post → -
API documentation tools: the short list
API documentation tools explained: the short list of contenders, when a dedicated tool matters, when a wiki is enough, and where the docs live between releases.
api documentation tool · api documentation tools · best api documentation tool
Read the post → -
How to write a postmortem in one page
How to write a postmortem: the seven-section shape, the blameless rule, why timeline comes before root cause, and where the doc has to live to get read.
how to write a postmortem · blameless postmortem · how to run a postmortem
Read the post → -
Design strategy: a working framework
Design strategy explained without jargon: what it is, how it differs from design thinking, a working five-step framework, and where the doc actually lives.
design strategy · ux design strategy · product design strategy
Read the post → -
Incident response playbook in one page
Incident response playbook explained: what it is, the six phases that matter, where it has to live to be useful at 04:00, and when not to bother writing one.
incident response playbook · incident response playbooks · what is an incident response playbook
Read the post → -
Quarterly business review without slides
Quarterly business review explained: what a QBR is, a working agenda, what to put in the doc instead of slides, and when a small team can skip the meeting.
quarterly business review · qbr meeting · what is a quarterly business review
Read the post → -
Digital workspace: a no-fluff guide
Digital workspace explained without jargon: a definition, platform examples, where the wiki fits in your stack, and when a Slack-plus-Drive combo is enough.
digital workspace · collaborative workspace · what is a digital workspace
Read the post → -
SLO vs SLA: a plain-English comparison
SLO vs SLA in plain English: an internal target versus a contractual promise. Why SLOs run tighter, what error budgets buy you, and where SLOs go to rot.
slo vs sla · sla vs slo · sla slo
Read the post → -
Obsidian alternatives: when a solo vault stops scaling
Obsidian alternatives for when one vault, one writer, and one laptop stops being the right shape. Here's what to look for, what tools fit, and how to leave.
obsidian alternatives · obsidian alternative · alternative to obsidian
Read the post → -
Team charter: a working version you can write today
A team charter is the document that says how your team works. Most are forgotten by Tuesday. Here's what to include, what to skip, and how to make yours stick.
team charter · team charter example · what is a team charter
Read the post → -
Confluence vs Jira: the difference and when you need both
Confluence is a wiki, Jira is an issue tracker. Both Atlassian, both store information, both confuse new buyers. Here's when to use each, and when to use both.
confluence vs jira · jira vs confluence · confluence jira
Read the post → -
What is Confluence: a fair look at Atlassian's wiki
Confluence is the wiki Atlassian shipped in 2004 and still the most-deployed corporate wiki in 2026. Here's what it does, what it doesn't, and when to leave.
what is confluence · confluence wiki · confluence documentation
Read the post → -
AI knowledge base: what it is when agents read too
An AI knowledge base is one your agents can read as easily as your humans. Here's what that means in 2026, what it requires, and where it still falls short.
ai knowledge base · ai powered knowledge base software · ai based knowledge management system
Read the post → -
Corporation wiki: what teams need and most vendors miss
A corporation wiki is the system your team writes things down in. Most vendors don't run on theirs. Here's what to look for, and how to spot the real ones.
corporation wiki · wiki for teams · confluence wiki
Read the post → -
Knowledge base software: nine picks, one moral threshold
Knowledge base software for teams tired of slow: nine picks ranked by what your team actually does, with the migration story and speed math for each tool.
knowledge base software · best knowledge base software · internal knowledge base software
Read the post → -
Knowledge management software: search faster than asking
Knowledge management software for teams that want real answers before they Slack a coworker — definitions, examples, criteria, and the picks that earn it.
knowledge management software · best knowledge management software · knowledge management system examples
Read the post → -
The best markdown editor in 2026, ranked by what you write
Best markdown editor in 2026 by what you actually write: code, prose, knowledge bases, team docs. Eight editors compared with the trade-offs spelled out.
best markdown editor · best editor for markdown · what does markdown editor mean
Read the post → -
Knowledge management best practices, the working version
Knowledge management best practices for teams that use their wiki: governance, ownership, search faster than Slack, and the eight habits that stick.
knowledge management best practices · best practices for knowledge management · knowledge management strategy
Read the post → -
Notion alternatives, ranked by what your team actually does
Notion alternatives for teams that have outgrown the database-doc hybrid: a head-to-head on speed, search, and the eight worth importing into.
notion alternatives · notion alternative · alternative to notion
Read the post → -
Obsidian vs Notion: which one does your team actually need
Obsidian vs Notion compared honestly: speed, plugins, collaboration, and which one is the right fit for solo writers, small teams, and growing companies.
obsidian vs notion · notion vs obsidian · obsidian alternative
Read the post → -
What is a knowledge base, and what separates a useful one
What is a knowledge base in plain English: the difference between a knowledge base and a database, the kinds that exist, and why a slow one isn't really one.
what is a knowledge base · knowledge base article · knowledge base articles
Read the post →