experimental optimizations + docs