based on the poking around i did this morning, here's the kind of document that would be nice to have. 1: Overview - what yum does (basic operations) 2: The components - [optional] install via RPM - the parts and what they're for yum (client side) yum-arch (build a repository) /etc/yum.conf /var/log/yum* /var/cache/yum/ additional: /etc/init.d/yum /etc/cron.daily/yum.cron /etc/logrotate.d/yum for newbies, i'd probably suggest de-activating any automated yum for the time being, to give the admin a chance to get used to doing it manually. and *emphasize* that this doc focuses on simple client-side install/upgrade/remove. 3: /etc/yum.conf - explain contents, focus mainly on servers, plus - where to find yum repositories based on your OS - how to recognize one when you find it (RPMS/, headers/) (explaining what a repository looks like is useful so that, later, it's easier to explain yum-arch if someone realizes that what they have to end up with needs to have RPMS/ and headers/) 4: Basic operations 4.1: Listing 4.2: Upgrading/installing 4.3: Removing 5: Troubleshooting - log files for now, i'm interested in what a newbie can do in terms of just *listing* the current setup/status/available packages, etc. that is, can one verify the availability of a specific (alleged) repository? what's available to download/upgrade/install. anything that does not involve actually changing the system state. i'm willing to write this up once i figure it out, i'll just need a little help. rday