Test your Docs, and Doc your Tests

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.

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.

This is intended to be a lightning talk of about ten minutes; I might be able to chop it down to five if needed, or stretch it out to fifteen or so with examples from additional languages but I think that would get boring.