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.
64 posts so far. New ones land most weeks. Looking for a starting point instead? Browse the wiki templates.
-
Confluence export: every way out, and what each one keeps
A complete guide to Confluence export — single-page PDF and Word, space HTML and XML, full-site Atlassian Cloud export, and the REST API — with what each keeps and loses.
confluence export · export confluence page · confluence space export
Read the post → -
Best tools for remote work: five shapes, one stack
Best tools for remote work come in five shapes: communication, tasks, files, security, and the written record. Match the shape, not the feature list.
best tools for remote work · remote work tools · remote work software
Read the post → -
Version control for documents: a practical guide
Version control for documents means every edit is tracked and reversible — no more final-v3-FINAL.docx. How it works, the best practices, and the right tools.
version control for documents · document version control · document versioning
Read the post → -
Collaboration tools for teams: five shapes that fit
Collaboration tools for teams come in five shapes. Match the tool to the work — chat, video, tasks, files, or docs — and import your wiki in about 10 minutes.
collaboration tools for teams · collaboration tool · collaboration apps
Read the post → -
Software documentation tools: how to pick the right one
Software documentation tools come in five shapes. Here's what each is for, how to choose between them, and which docs belong in a fast team wiki instead.
software documentation tools · software documentation tool · automated documentation tools
Read the post → -
Knowledge sharing platform: share it, don't store it
A knowledge sharing platform's job is getting knowledge out to your team, not just storing it. How it differs from a knowledge base, and how to choose.
knowledge sharing platform · knowledge sharing tools · team knowledge sharing platform
Read the post → -
Intranet solutions: five shapes and how to pick one
Intranet solutions come in five shapes, and most teams need just one. Match the shape to what you actually run, then import your old wiki in ten minutes.
intranet solutions · best intranet solutions · cloud intranet solutions
Read the post → -
Knowledge management platform: one hub, picked honestly
A knowledge management platform promises one place for everything your team knows. Here's what that means, the five shapes it ships in, and how to choose one.
knowledge management platform · enterprise knowledge management platform · internal knowledge platform
Read the post → -
Knowledge management tools: the five shapes that fit
Knowledge management tools come in five shapes. Here's how to match the tool to the knowledge you're managing — and migrate a space in about ten minutes.
knowledge management tools · enterprise knowledge management software · types of knowledge management tools
Read the post → -
Confluence alternatives, ranked by why you're leaving
Confluence alternatives for teams tired of slow pages and rising bills — the five shapes worth moving to, and how to migrate a space in about ten minutes.
confluence alternatives · confluence alternative · alternatives to confluence
Read the post → -
Process documentation software: how to choose and use it
Process documentation software comes in five shapes. Here's what each is for, what good process documentation contains, and how to keep it from going stale.
process documentation software · business process documentation software · what is process documentation
Read the post → -
Investment memo: what it is and how to write one
An investment memo is the written argument for a bet with money attached. Here's what goes in one, how to write it, an example, and where it should live after.
investment memo · investment memo example · what is an investment memo
Read the post → -
Internal documentation: a practical guide for teams
Internal documentation is the writing your team does for itself. Here are the types, the internal-vs-external line, and how to keep docs people actually find.
internal documentation · why is documentation important · engineering documentation
Read the post → -
SaaS knowledge base: the two kinds and how to build
A SaaS knowledge base is really two things — a customer help centre and an internal wiki. Here's the difference, what goes in each, and how to build both.
saas knowledge base · knowledge base saas · saas knowledge base examples
Read the post → -
How to build a knowledge base: the platform-first guide
How to build a knowledge base your team will actually open — start with the platform, then the page tree, then the first ten articles. The right order matters.
how to build a knowledge base · how to create a knowledge base · how to make a knowledge base
Read the post → -
Guru alternatives: five shapes for five different teams
Guru alternatives mapped to five team shapes — sales enablement, customer support, engineering, internal wiki, AI search — and how to pick the right one.
guru alternatives · alternatives to guru · guru competitors
Read the post → -
How to write a knowledge base article that gets read
How to write a knowledge base article that actually gets read — one job per article, structure for search, plus the discipline that keeps the KB usable.
how to write a knowledge base article · knowledge base article examples · knowledge base article best practices
Read the post → -
Notion vs Trello: workspace vs board, and which fits when
An honest Notion vs Trello comparison — what each is actually good at, how the kanban-vs-workspace split shakes out, and when most teams just run both.
notion vs trello · trello vs notion · is notion better than trello
Read the post → -
Internal knowledge base: build one your team uses
An internal knowledge base is what your team writes for itself. Here's what it is, how it differs from a customer KB, and how to make one that gets used.
internal knowledge base · what is internal knowledge base · internal knowledge base examples
Read the post → -
Notion vs ClickUp, Monday, and Airtable: a fair look
Notion versus the workspace tools it's most often compared to — ClickUp, Monday, and Airtable. What's actually different, and which fits which team.
notion vs clickup · notion vs monday · monday vs notion
Read the post → -
Notion vs Google Docs: where each fits, where neither does
An honest Notion vs Google Docs comparison — what each is actually good at, where both miss, and how to pick the one your team will be using in six months.
notion vs google docs · google docs vs notion · can notion replace google docs
Read the post → -
Onboarding documents: what to include, where each lives
Onboarding documents in two halves — the HR forms your HRIS handles, the role docs your wiki carries, and what makes either set actually get read in week one.
onboarding documents · onboarding document · onboarding documentation
Read the post → -
Planning board: what it is, how to make one work
A planning board makes the team's near-future work visible. Here's what it is, the four shapes that actually work, and where the source-of-truth lives.
planning board · plan board · agile planning board
Read the post → -
Work management: what it actually means in 2026
Work management is the discipline behind project, time, and team tools — what it actually means, how it differs from project management, and where it lives.
work management · work management system · what is work management
Read the post → -
Notebook apps in 2026: five shapes and where they fit
The honest 2026 guide to notebook apps — five distinct shapes mapped to who actually uses them, and the wiki question for when your team needs more.
notebook app · best notebook app · digital notebook app
Read the post → -
Time management tools in 2026: a fair roundup
The honest 2026 guide to time management tools — five shapes mapped to who they actually fit, and the wiki next door that makes the discipline stick.
time management tools · time management apps · time management system
Read the post → -
Project management tools in 2026: a fair roundup
The honest 2026 guide to picking project management tools — five shapes of tool mapped to five team types, and the wiki question that's separate.
project management tools · project management tool · project tracker
Read the post → -
What is Coda: the doc that thinks it's a database
Coda is the doc-and-database hybrid that pitches itself as one tool to replace them all. Here's what it actually is, what it does well, and when to leave.
what is coda · coda ai · coda meaning
Read the post → -
What is Jira? A fair look at Atlassian's issue tracker
Jira is the issue tracker most engineering teams already use. Here's what it is, what it does well, where it struggles, and why the wiki is separate.
what is jira · what is jira and confluence · jira documentation
Read the post → -
What is Notion? A fair look at the everything-app
Notion is the workspace app that became a wiki, a database, and a doc editor at once. Here's what it actually is, what it does well, and when to leave.
what is notion · what is notion software · what is the notion app
Read the post → -
Notion vs Confluence: structure, speed, and the exit
Notion vs Confluence, compared on the axes the roundups skip: structure versus flexibility, speed, and whether you can get your content back out again.
notion vs confluence · confluence vs notion · notion vs confluence comparison
Read the post → -
Product launch checklist (2026): the items that matter
A product launch checklist by phase: pre-launch, launch day, and post-launch — plus the timeline by tier and the one item that decides whether it lands.
product launch checklist · product launch plan · how to launch a product
Read the post → -
Disaster recovery plan example: full walkthrough + checklist
A disaster recovery plan example, walked through section by section — RTO, RPO, the checklist, and the one rule that decides if the plan survives the disaster.
disaster recovery plan example · disaster recovery plan checklist · disaster recovery plan steps
Read the post → -
Second brain apps: how to choose one that actually sticks
Second brain apps compared by the one thing the roundups skip: how fast you get a note back out. How to choose, when a solo vault is enough, and how to move in.
second brain apps · second brain app · obsidian second brain 2025
Read the post → -
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, examples, and 2026 uses
What is an intranet: the plain-English definition, how it differs from the internet and extranet, what one looks like in 2026, and seven examples worth copying.
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, 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: which one fits your team
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 your team will read
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 that lands
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: a one-page guide
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: how to run one 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 for 2026
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 for teams
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: what's the difference, and do 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 — how it works and when to leave
Confluence is Atlassian's corporate wiki, shipped in 2004 and still the default in 2026. Here's what it does well, where it struggles, 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 → -
Corporate wiki software: what it is and how to choose
A corporate wiki is where your team writes things down. Here's what corporate wiki software is, the categories to know, and how to pick one your team will actually open.
corporate wiki software · enterprise wiki · corporation 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 in 2026.
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? Definition, types, and the test
What is a knowledge base in plain English: a clear definition, the four kinds that exist, the difference from a database, and the test a useful one has to pass.
what is a knowledge base · knowledge base definition · knowledge base meaning
Read the post →