Collapse multi-line @param / @return descriptions onto single lines

[turegjorup]

Summary

Dedicated follow-up stacked on top of PR #45 (PR C). A few docblocks in OpenIdConfigurationProvider and the test suite had their @param / @return descriptions wrapped onto a continuation * line:

* @param int $length
*                    Length of the random string to be generated
*
* @return string
*                The generated state

The phpdoc_align: vertical rule from the @symfony preset doesn't create those wraps — it just aligns whatever multi-line structure already exists in the source. The wrap was a best-effort output of an earlier auto-format pass, not a deliberate style choice.

Flattening each description back onto its tag line lets the @symfony rule pad the columns into a tidy aligned table instead:

* @param string|null $postLogoutRedirectUri The URL …
* @param string|null $state                 If a state …
* @param string|null $idToken               The id token

No .php-cs-fixer.dist.php change — the @symfony default produces the clean output once the source isn't pre-wrapped. Future single-line tags stay single-line under the same rule.

Also in this PR

Consolidates two ### Documentation subsections under [Unreleased] (left over from PR #44) into one. markdownlint's MD024 was flagging the duplicate heading.

Test plan

• task lint:php — clean (phpdoc_align: vertical accepts the flattened form).
• task lint:markdown — clean (no duplicate-heading warning).
• task test:coverage — 100% on OpenIdConfigurationProvider (24/24 methods, 161/161 lines).
• task analyze:php — no errors.
• CI matrix on PR.

Base

Targets feature/phpstan-max-completion (PR #45). When PR #45 merges to develop, this PR auto-retargets.

🤖 Generated with Claude Code

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 100.00%. Comparing base (820dc08) to head (716bcfa).

Additional details and impacted files

@@             Coverage Diff             @@
##             develop       #46   +/-   ##
===========================================
  Coverage     100.00%   100.00%           
  Complexity        71        71           
===========================================
  Files              1         1           
  Lines            185       185           
===========================================
  Hits             185       185           

Flag	Coverage Δ
unittests	100.00% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.