marks 'done' method as deprecated @ the doc level [skip ci]

## motivation

For the purposes of documentation, the 'done' method has been marked deprecated.

No runtime warning is generated.