api changes + docs