Fix documentation to make it clear references must match - and not that a specific pattern must be followed