Add @example decorator

[sharkdp]

We could add a @example(…) decorator for function definitions. This way, we could show exemplary usage of a function. For the documentation, we would (1) run this through the Numbat interpreter and also show the result; and (2) show a "try this" link to https://numbat.dev