Function-level @template triggers 'Parameter tags must be defined first in a doc comment'

Problem/Motivation

It seems odd to me to put a function-level @template at the end of the doc block, but if at the beginning it triggers:

ERROR: Parameter tags must be defined first in a doc comment

Steps to reproduce

/**
 * Returns an API decorator for the given client class.
 *
 * @template T
 *
 * @param class-string<T> $class
 *   The class to decorate.
 *
 * @return \Drupal\myapi\ApiDecorator<T>
 *   The decorator.
 */
function getDecorator(string $class): ApiDecorator {

Proposed resolution

Support having a @template before @param.

Remaining tasks

User interface changes

API changes

Data model changes