document patch

Fixes #3238 

Be sure to cherry-pick to gh-pages when merged