Answer with docs

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.

Originally published at https://andrew-jones.com/blog/answer-with-docs/.

Cover image from Unsplash.

--

--

--

Software engineer and tech lead. Enjoy solving problems and getting things done. Always looking to learn and improve.

Love podcasts or audiobooks? Learn on the go with our new app.

Recommended from Medium

Yes , i am totally excited at this moment.

CSS box-model

when it comes to solar.

My Bangkit journey so far

Fuel Management System Market is estimated to reach USD 856.4

FHIR + openEHR — 2022

CRADLE VSA:Patient Referral Management System

Best practices courses

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store
Andrew Jones

Andrew Jones

Software engineer and tech lead. Enjoy solving problems and getting things done. Always looking to learn and improve.

More from Medium

Putting the platform to work

Apple’s Tap to Pay, Doctors without Reviews, SMBs Staffing Struggles

What is Stitchia Network? v1.0