better docs and make err a hard dependency