updated workaround docs