additional docs on shims for issue 1040