document the actual initial motivation for _shimmed
Merge pull request #3923 from mozilla/include_js_shimmed_doc

document the actual initial motivation for _shimmed