Please Automatically Test Your Documentation!

Nik Everett (14.Jul.2018 at 13:30, 1 hr )
Talk at Mid-Atlantic Developer Conference (English - US)

Rating: 4 of 5

Nik Everett found that automatically rigging up something to automatically test your documentation is super useful for making sure it is up to date. It doesn't have to be complex or beautiful. It just has to run. He'll teach you how to duplicate his approach because he might have to use your software someday.

In this talk you will:
*hear some anecdotes about the dark times before Elasticsearch's docs where tested automatically
* learn about the tools they built to test their documentation
* follow the journey from no test coverage of the docs to near complete coverage
* learn how to inspire others to do the same

All of what the Elasticsearch team built is open source and freely reusable but is tuned for the particular kind of docs they have and as such probably aren't useful to you. Nik offers inspiration and processes to copy.

Who are you?

Claim talk

Talk claims have been moved to the new Joind.in site.

Please login to the new site to claim your talk

Want to comment on this talk? Log in or create a new account or comment anonymously

Write a comment

 
Please note: you are not logged in and will be posting anonymously!
= three minus one

Comments

Rating: 4 of 5

14.Jul.2018 at 15:50 by Philip Sharp (62 comments) via Web2 LIVE

Interesting process going from un-checked-in documentation to fully-tested code examples.

© Joind.in 2018