lint, docs, minor API modifications