[skj]

I think it's important for example code to also be correct. If it needs to gloss over some details, put them in a function call that isn't defined.

Using an unprotected map here is incorrect.

[lazyjones]

Absolutely! Example code affects programming style and teaches people. It should be correct (and in good style), this is probably very much underrated.