gistfile1.php

/**
 * Data provider.
 *
 * Description.
 *
 * @since x.x.x
 *
 * @see {method name receiving data}
 *
 * @otherPHPUnitSpecificItems
 *
 * @return array {
 *     @type type $param_name_in_receiving_method Desciption.
 *     @type type $param_name_in_receiving_method Very long description that gets
 *                                                wrapped to the starting point.        
 * }
 */



EXAMPLE::
/**
 * Data provider.
 *
 * Provides various post_args to induce error messages in the that can be
 * compared to the expected_results.
 *
 * @since 4.3.0
 *
 * @see test_ajax_load_available_items_error_messages
 *
 * @return array {
 *     @type array $post_args        The arguments that will merged with the $_POST array.
 *     @type array $expected_results The expected results from the ajax call.
 * }
 */