Please see image:
Current editing and maintaining example code is difficult. It's hard to enter code here in nice format - I can write code on the fly, but I'll lose code hinting and there is a chance that I'll make mistake, I can write code In editor and copy it here but there is problem with asterisk suffixes. Both solutions seems hard to use.
Perfect solution would be to:
- allow code hinting is code examples
- apply refactoring also to code examples, so they will stay consistent with refactoring (like changing method name in whole project/framework)
In my opinion this is very important improvement feature, which will make creating & maintaining docs much easier & faster.