user_example_tests#

Tests specifically for the purpose of user examples.

Example tests differ from most in that the target audience is the user. The unit of test for example tests is an action. An action may consist of calling multiple methods in an attempt to show a complete usage example.

These tests should be replete with comments describing what steps are being taken, why they are being taken, and why the results are as they are.