Skip to content

Improve documentation coverage#512

Open
dereuromark wants to merge 2 commits into3.xfrom
improve-documentation
Open

Improve documentation coverage#512
dereuromark wants to merge 2 commits into3.xfrom
improve-documentation

Conversation

@dereuromark
Copy link
Member

Summary

Addresses documentation gaps identified in the codebase:

  • Expand README with ChronosTime, setTestNow(), and ClockFactory (PSR-20) examples
  • Improve ClockFactory class and method documentation
  • Add detailed docs for createInterval() explaining time unit rollover behavior
  • Improve average() docs with example showing midpoint calculation
  • Improve diffFiltered() docs with callback signature and usage example
  • Improve nthOfMonth/Quarter/Year docs explaining the false return case

The README now covers more of the public API including commonly used testing utilities.

- Expand README with ChronosTime, setTestNow, and ClockFactory examples
- Improve ClockFactory class and method documentation
- Add detailed docs for createInterval() explaining rollover behavior
- Improve average() docs with example showing midpoint calculation
- Improve diffFiltered() docs with callback signature and example
- Improve nthOfMonth/Quarter/Year docs explaining false return case
@dereuromark dereuromark added this to the 3.next milestone Mar 22, 2026
- Clarify @param for $dayOfWeek to specify Chronos constants
- Improve min() docs explaining it returns the earlier datetime
- Improve max() docs explaining it returns the later datetime
- Document that null defaults to current time for min/max
@dereuromark dereuromark requested a review from LordSimal March 22, 2026 23:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant