pimp the documentation