update descriptions for machine resources