remove some text which is misleading for `linear`
fix typos in docs