I think inline comments are not allowed but maybe a simple docblock would be enough here:
```php
/**
 * Allow basic type field to be remplaced by a `Document` / `DocumentSet` type.
 */
```