note the use case for tests and docs functions and that "test_require" is deprecated, shorten description of the example