Skip to content

docs: audit schedulers and terminables pages#18

Merged
demengc merged 1 commit intomainfrom
docs/audit-schedulers-terminables
Mar 24, 2026
Merged

docs: audit schedulers and terminables pages#18
demengc merged 1 commit intomainfrom
docs/audit-schedulers-terminables

Conversation

@demengc
Copy link
Copy Markdown
Owner

@demengc demengc commented Mar 24, 2026

Summary

  • Audited schedulers.md and terminables.md against all source interfaces (Schedulers, Scheduler, Task, TaskBuilder, ContextualTaskBuilder, ContextualPromiseBuilder, Promise, Terminable, TerminableConsumer, CompositeTerminable, TerminableModule)
  • Added missing documentation for Schedulers.builder() API, all Scheduler methods (supply, call, supplyLater, callLater, and TimeUnit overloads), Promise chain methods (thenApply/Accept/Run/Compose with Sync/Async/Delayed variants), Ticks utility, and CompositeTerminable method table
  • Fixed code examples: replaced thenApplySync with thenAcceptSync where return value was unused, replaced inline tick arithmetic with TaskBuilder TimeUnit API
  • Removed emoji checkmarks from terminables.md, removed redundant inline comments from all code examples
  • Added interface hierarchy table to terminables.md confirming BasePlugin implements TerminableConsumer
  • Restructured both pages with informative headings, method reference tables, and parallel structure

Test plan

  • Verify markdown renders correctly on GitBook
  • Spot-check code examples against source API signatures

Verified all method names, signatures, parameter orders, and return
types against source code. Key changes:

schedulers.md:
- Add Scheduler access table (sync, async, get, bukkit, builder)
- Add complete Scheduler methods table with all overloads
- Document TaskBuilder API (builder chain, timing, terminal methods)
- Document Promise chain methods (thenApply/Accept/Run/Compose Sync/Async)
- Add Ticks utility section with conversion methods and constants
- Fix Promise example to use thenAcceptSync instead of thenApplySync
  where the return value was unused
- Replace inline tick arithmetic with builder TimeUnit API in examples
- Restructure with informative headings and tables

terminables.md:
- Add interface hierarchy table covering Terminable, TerminableConsumer,
  CompositeTerminable, TerminableModule, Task, and Promise
- Confirm BasePlugin implements TerminableConsumer
- Add CompositeTerminable method table (create, createWeak, with,
  withAll, cleanup, bind, bindModule)
- Remove emoji checkmarks from Benefits section
- Consolidate "Benefits", "Without Terminables", and "With Terminables"
  into a single comparison section
- Remove redundant inline comments from code examples
@demengc demengc merged commit b99a98c into main Mar 24, 2026
2 of 3 checks passed
@demengc demengc deleted the docs/audit-schedulers-terminables branch March 24, 2026 02:01
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.

1 participant