more documentation; take the chance to shit on apt2