add shim and a doc