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.