Validating Documentation Through Innovative Tools

Today, we have Manny Silva, Head of Docs at Skyflow, on the show to talk about two open source projects he created, Docs as Tests and Doc Detective. Docs as Tests is a framework to make sure that your docs are in sync with your product. It's essentially a way to test your docs just like engineers test their code, and Doc Detective is Manny's implementation of that framework.

We discuss the history and motivation behind the projects, what they enable, and how people are using it today.

Timestamps

01:57 Intro

06:51 Testing Documentation

09:26 Competing Against

11:26 Docs as Tests & Doc Detective

13:32 How does one apply these ideas?

16:49 How does test writing work?

19:26 Out of the box checks

23:15 Configurations Structure to create tests

24:28 Integration with the normal flow

28:20 Freshness

29:13 Tools used to build it

32:02 Open Source

33:27 Limitations

35:31 MongoDB's version of Docs as tests

36:42 Innovation Engine by Azure

37:27 Teams using Doc Detective

38:12 At Skyflow

40:52 Future

41:41 How to get started

45:18 Rapid Fire

Links

Docs as Tests: https://www.docsastests.com/

Doc Detective: https://doc-detective.com/