improve appliance documentation