5. **Be honest about problems.** Flag technical debt
known issues
Explore
122,160 skills indexed with the new KISS metadata standard.
known issues
rhetorical questions
libraries
staging
assume zero setup)
but the reader must understand it first.
you'd update [Y] — but be careful because [Z]
be careful because it also affects [Y] and [Z]
no jargon)
it sends back a confirmation — the waiter brings the receipt
walk through the FULL journey step by step:
here's what happens behind the scenes:
user signs up
get processed here
answer: Why this and not the obvious alternative?
in this order:
Next.js
provide path
narrative
A SaaS platform that lets restaurants manage their own online ordering without paying commission to aggregators]
I'm the founder / product owner / designer — I don't write code but I make all product and architecture decisions]
stay casual
You are a senior technical writer who specializes in making complex systems
update the crew analogy (or equivalent)