refactor: Improve types for phpstan

[neznaika0]

Description
Improved typing.
What is done:

• Added a "dot" at the end of the descriptions
• Since CIUnitTestCase, the dependent code has been updated
• Updated types in related functions in Common.php
• Properties have been added for traits. If it is redundant, some can be deleted, phpstan does not consider this a mistake.

OFFTOP: I'll ask again: Do we really need repeated code descriptions? (You answered Yes.)
Because of this, it needs to be fixed in several places. See, example $namespace property. Modern IDEs fully support type highlighting and you can switch to declarations. If not, then is it worth adding missing comments everywhere? I would leave it as it is now, but this contradicts the desire to duplicate the code: Everywhere without repeating, or always duplicate typing.

Checklist:

• Securely signed commits
• Component(s) with PHPDoc blocks, only if necessary or adds value
• Unit testing, with >80% coverage
• User guide updated
• Conforms to style guide

[paulbalandan]

I'm not a fan either of duplicating code comments and PHPDocs. If those are already defined by the base class or interface, then child classes can remove them since, as you said, IDEs will show you the inherited code comments (unless you are not using an IDE?). It is also a maintenance burden to keep similar comments in sync.

[neznaika0]

If I'm not mistaken, @samsonasik is against deletion.

[samsonasik]

can @inheritDoc be used?

[neznaika0]

Why? Inheritance works fine without it. Maybe the tag is needed when generating documentation? I don't see the need for it during development.

Look at $namespace, $seed - the properties have different values, but the type is specified again.

[paulbalandan]

If I remember correctly, @inheritDoc is needed by phpDocumentor for its generated API docs. But IDEs work perfectly without it and there are other documentation generators that can generate API docs without @inheritDoc.

[neznaika0]

Tags should be updated if the type changes or becomes more precise (int|string > object). Am I wrong?

[paulbalandan]

Yes, they should be updated.

[michalsn]

If phpDocumentor requires @inheritDoc, then we should include it.

[neznaika0]

Okay. Can we fix the style in the Markdown guidelines or user guide?

I would like to have an exact strategy for further refactoring (example Commands, Request, Model,..). It may be necessary to remove all "bad" files from the comments. Alternatively, you can add @inheritDoc.

This may reduce the size of the installation ZIP archive.

[github-actions]

👋 Hi, @neznaika0!

We detected conflicts in your PR against the base branch 🙊
You may want to sync 🔄 your branch with upstream!

Ref: Syncing Your Branch