attributes: update docs for instrument

[mladedav]

Motivation

Docs were obsolete for the instrument macro.

Closes #2895

Solution

I've updated the docs and addeda a doctest example.

This should also be cherry-picked onto v0.1.x