Посмотрел тут в личные utility-библиотеки. Оказалось, что примеры в докстрингах это довольно популярно. У одного человека даже есть отдельная хреновина, которая проверяет их валидность.
Из этого наблюдения надо бы сделать какие-то выводы, но я никаких не сделаю.