We could extract the example code as compiling code and then cut&paste it into the documentation. Having the actual code snippets compile will ensure they are correct and we can also apply our coding standard on these code examples.

Of course the disadvantage is that we need to manually keep code and docs in sync.

See also the Validator documentation module where we applied this approach.