Skip to content

docs: add class-level PHPDoc to all major classes (closes #60)#154

Merged
s2x merged 1 commit into
mainfrom
docs/issue-60-class-level-phpdoc
Jul 6, 2026
Merged

docs: add class-level PHPDoc to all major classes (closes #60)#154
s2x merged 1 commit into
mainfrom
docs/issue-60-class-level-phpdoc

Conversation

@s2x

@s2x s2x commented Jul 6, 2026

Copy link
Copy Markdown
Contributor

Description

Closes #60

Changes

  • Added class-level PHPDoc blocks to all 15 source files
  • Each block follows consistent format: one-line purpose, usage paragraph, and @see cross-references
  • All @see references verified against actual methods and classes
  • Fixed 5 issues from code review (inaccurate descriptions, broken references, style inconsistencies)

Files updated: src/ZVec.php, src/ZVecException.php, src/ZVecCollectionOptions.php, src/ZVecCollectionStats.php, src/ZVecFieldSchema.php, src/ZVecIndexParams.php, src/ZVecQueryInterface.php, src/ZVecVectorQuery.php, src/ZVecGroupByVectorQuery.php, src/ZVecSchema.php, src/ZVecDoc.php, src/ZVecRerankedDoc.php, src/ZVecRrfReRanker.php, src/ZVecWeightedReRanker.php, src/ZVecReRanker.php, CHANGELOG.md

Testing

  • Builds locally (PHP-only change, no FFI changes)
  • All .phpt tests pass (59 pre-existing failures on main — unchanged)
  • No test database leftovers

Code Review

  • Passed subagent code review (2 rounds)
  • All review comments addressed

Add class-level PHPDoc blocks to all 15 source files:
ZVec, ZVecException, ZVecCollectionOptions, ZVecCollectionStats,
ZVecFieldSchema, ZVecIndexParams, ZVecQueryInterface, ZVecVectorQuery,
ZVecGroupByVectorQuery, ZVecSchema, ZVecDoc, ZVecRerankedDoc,
ZVecRrfReRanker, ZVecWeightedReRanker, ZVecReRanker.

Each block follows a consistent format: one-line purpose, usage
paragraph, and @see cross-references to related classes/methods.
All references verified against actual methods and classes.
@s2x s2x self-assigned this Jul 6, 2026
@s2x
s2x merged commit 14958dc into main Jul 6, 2026
3 checks passed
@s2x
s2x deleted the docs/issue-60-class-level-phpdoc branch July 6, 2026 19:30
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.

DOC-001: Missing Class-Level PHPDoc on All Major Classes

1 participant