Drupal code style has rules to format PHPDoc section, here they are: https://www.drupal.org/docs/develop/standards/php/api-documentation-and-comment-standards

But now the extension doesn't match all of them:

  1. Class names should be in the fully qualified namespace.
  2. Should be an empty line between the description text and function parameters, and before the return.

Here is an example of the correct PHPDoc block and generated one:

Could you please implement this?

    Thank you for the suggestion! Yes, we can do that, I'm adding it to the list.

      it's about phpdoc generation (and/or code formatting?)

      • type names should be FQN (although we work ok with shortened names)
      • parameters and return summary on the next line
        a month later

        We have implemented PHPDoc generator so it respects "php.completion.autoimport-docblock" setting.

        Set it to "fqn" to generate fully qualified names in doc comments above functions.

        (available in the upcoming pre-release)

          Write a Reply...