PHPUnit data providers can have test docs too!

test.php

<?php
    public function providerGetEventId() {
        return array(
            'wrong way around' => array(
                'Premier League',
                array('id' => 5,'name' => 'Hull', 'shortname' => 'HUL'),
                array('id' => 6,'name' => 'Manchester City', 'shortname' => 'MNC'),
                null
            ),
            'different event type' => array(
                'FA Cup',
                array('id' => 1,'name' => 'Liverpool', 'shortname' => 'LIV'),
                array('id' => 2,'name' => 'Man Utd', 'shortname' => 'MNU'),
                null
            ),
        );
    }