document stuff and reduce imports