Tame Two Tedious Tasks Together, with Doctests

By Dave Aronson

Elevator Pitch

Do the examples in your documentation get out of date? Are the examples in your tests hard to understand? Do you wish you could combine them? In some languages, you can! This talk is about doctests, as used in languages such as Python and Elixir, using documents with real tests embedded.

Description

Do the examples in your documentation get out of date? Are the examples in your tests hard to understand? Do you wish you could combine them? In some languages, you can! This talk is about doctests, as used in languages such as Python and Elixir, using documents with real tests embedded.

Notes

This is intended to be a lightning talk of about ten minutes, for either language. I might be able to chop it down to five if needed, or stretch it out to fifteen or so by including both languages. Maybe even twenty with examples from additional languages, but I think that would get boring.