@todo

The @todo tag records an unfinished piece of work related to the element it annotates, so that it can be tracked and picked up later instead of being forgotten as a stray code comment. Documentation generators and IDEs can collect every @todo across a codebase into a single worklist.

Parsing a @todo tag produces a TodoTag instance. Being a pure marker, it adds nothing beyond the $name and optional $description every Tag already carries — in practice the description is what gives the tag its value, since a bare @todo says nothing about what remains to be done.

Defined by the PSR-19 draft (FIG proposed PHPDoc Tags, §5.16) and by phpDocumentor.