Skip to content

Docs: add and align missing @ since annotations across Two-Factor providers#809

Merged
masteradhoc merged 4 commits intoWordPress:masterfrom
masteradhoc:since-documentations
Feb 24, 2026
Merged

Docs: add and align missing @ since annotations across Two-Factor providers#809
masteradhoc merged 4 commits intoWordPress:masterfrom
masteradhoc:since-documentations

Conversation

@masteradhoc
Copy link
Collaborator

What?

This PR adds and aligns missing @since annotations in provider docblocks across the Two-Factor plugin.
It also includes minor docblock formatting cleanup to keep inline documentation consistent and readable in code review.

Why?

Several provider methods were missing @since tags or had inconsistent version annotations.
This made historical tracking harder for maintainers and contributors, especially when reviewing API evolution and backport relevance.

How?

  • Added missing @since tags to provider class/method docblocks.
  • Updated selected @since values to the correct historical versions.
  • Cleaned docblock indentation/formatting where needed for consistent PHPCS-friendly style.
  • Kept changes documentation-only (no functional behavior changes).

Testing Instructions

  1. Review changed provider files and confirm each touched docblock has a valid @since line.
  2. Confirm version values match intended release history.

Screenshots or screencast

N/A (documentation-only change).

Changelog Entry

Changed - Added and normalized missing @since annotations in provider docblocks for clearer API/version history documentation.

@masteradhoc masteradhoc added this to the 0.16.0 milestone Feb 23, 2026
@github-actions
Copy link

github-actions bot commented Feb 23, 2026

The following accounts have interacted with this PR and/or linked issues. I will continue to update these lists as activity occurs. You can also manually ask me to refresh this list by adding the props-bot label.

If you're merging code through a pull request on GitHub, copy and paste the following into the bottom of the merge commit message.

Co-authored-by: masteradhoc <masteradhoc@git.wordpress.org>
Co-authored-by: georgestephanis <georgestephanis@git.wordpress.org>

To understand the WordPress project's expectations around crediting contributors, please review the Contributor Attribution page in the Core Handbook.

Copy link
Collaborator

@georgestephanis georgestephanis left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Lot of work to add these, much appreciated though!

(or is there some automated tool that digs back through versions? either way, cool!)

@masteradhoc masteradhoc self-assigned this Feb 24, 2026
@masteradhoc
Copy link
Collaborator Author

@georgestephanis manually, but was faster then expected!

@masteradhoc masteradhoc merged commit ba96fbb into WordPress:master Feb 24, 2026
29 checks passed
@masteradhoc masteradhoc deleted the since-documentations branch February 24, 2026 11:49
@masteradhoc masteradhoc changed the title Docs: add and align missing @since annotations across Two-Factor providers Docs: add and align missing @ since annotations across Two-Factor providers Mar 4, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants