The ongoing debate about doctests (here, and links therein) seems to me to be somewhat silly.
doctests should be assessed by their utility to you and your project, in whatever role you happen to be using them. I personally find them to be very useful in API documentation, where they …
read moreThere are comments.