yard-sorbet
A YARD plugin that parses Sorbet type annotations
Features
- Attaches existing documentation to methods and attributes that follow
sig
declarations. (This information is otherwise discarded.) - Translates
sig
type signatures into corresponding YARD tags - Generates method definitions from
T::Struct
fields - Generates constant definitions from
T::Enum
enums - Modules marked
abstract!
orinterface!
are tagged@abstract
- Modules using
mixes_in_class_methods
will attach class methods - Merges
sig
s in rbi files with source code documentation (rbi files must come after source code in yard configuration)
Usage
See the Plugin Support section of the YARD docs.
Used By
This plugin is used by:
- The Homebrew Ruby API
- Tapioca, to optionally include YARD documentation from sources when generating RBIs
-
yard-sorbet
itself