add more doc & change format for machine/packages