[Documentation] PSR12 - Return Type Declaration

[dingo-d]

The PR contains the documentation for the PSR12/Functions/ReturnTypeDeclaration sniff.

Description

This PR will add the documentation for the above-mentioned sniff, according to the official standard definitions.

Suggested changelog entry

Add documentation for the PSR12 ReturnTypeDeclaration sniff

Related issues/external references

Part of #148

Types of changes

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to change)
  • This change is only breaking for integrators, not for external standards or end-users.
• Documentation improvement

PR checklist

• I have checked there is no other PR open for the same change.
• I have read the Contribution Guidelines.
• I grant the project the right to include and distribute the code under the BSD-3-Clause license (and I have the right to grant these rights).
• I have added tests to cover my changes.
• I have verified that the code complies with the projects coding standards.
• [Required for new sniffs] I have added XML documentation for the sniff.

[jrfnl]

Thanks for this PR @dingo-d !

Just one remark about the description. Everything else seems perfectly fine.

[jrfnl]

As a standards description, this feels quite non-descript.

What about using the PSR12 phrasing (phrase just above the third code sample in the section) ?

[dingo-d]

I will update the description 👍🏼 This does feel a bit vague 😅

[jrfnl]

Thanks for updating the description @dingo-d ! LGTM.

[jrfnl]

Rebased and squashed, merging once the build passes.