Skip to main content

Answer with docs

·1 min
Cover image

As someone who works in an enablement team, I’m trying to instil a best practice of answering with docs. This has a number of benefits to both us and our users:

  • It ensures our documentation is constantly improving and being kept up to date
  • It trains users to look in the docs first, before asking, allowing them to self-serve
  • It reduces future toil

This means when a question comes in via Slack or otherwise we try to answer by linking to the documentation. If there isn’t any, first write some up and then use that as the answer. This should apply to our internal documentation and our own runbooks.

I’d be interested to hear if anyone else has tried something like this and how successful (or otherwise!) it’s been.

Cover image from Unsplash.


Want great, practical advice on implementing data mesh, data products and data contracts?

In my weekly newsletter I share with you an original post and links to what's new and cool in the world of data mesh, data products, and data contracts.

I also include a little pun, because why not? 😅

    Newsletter

    (Don’t worry—I hate spam, too, and I’ll NEVER share your email address with anyone!)


    Andrew Jones
    Author
    Andrew Jones
    I build data platforms that reduce risk and drive revenue.