rgmhtt
Of course it's vague if you do not yet understand it, but in fact it is not vague, it is well structured and thought out with a lot of work having gone into the yum implementation to get it to where it is now in sme server.
You are new to sme and making quite a bit of criticism in this and other posts.
I have had the pleasure of reading many systems documentation and have written some myself. One thing I have learned is that a community develops a way to document their technology and can be a little near-sighted on how others handle it. I have been quite guilty of this myself, RFC2510 really bit us; too many us-centric jokes which are now historic. A number of vendors where English was not their first language implemented ESP-NULL wrong because of those jokes.
I would suggest that you would be far better off to hold on to your comments until you get more familiar with sme and learn how it works and what it is doing, before jumping to conclusions and deciding that it's a bug or needs a NFR (New Feature Request).
If the documentation is missing or it takes extensive wiki searching to find it, that MIGHT be considered a bug in the documentation, or might be the style of the documenters. I was asked to submit bug reports on documentation 'problems'. It is up to the sme community to decide if I am correct, or 'just did not get it'. The fact that Chapter 6 starts out with "When installation is complete and if you set server console mode to "auto", the opening screen of the SME Server server console will appear: " but this panel now apparently no longer a part of the install is either a bug in the install or in the documentation. The choice is up to the sme developer community. This is NOT a criticism, but a report on a fact. Perhaps I could lighten my tone; I am a bit rushed to get something up before I head to IETF in SF tomorrow....
Please learn & understand how sme works, before wanting (others) to rewrite code for your perceived issues !
I report my observations as a newbie to sme, but far from a newbie to Samba, SMB, Centos, etc. So I AM trying to lean how sme works; I have to if I am going to use it.
Have you read
http://wiki.contribs.org/SME_Server:Documentation:FAQ#Yum_Updates
I suggest you read everything on the contribs.org and related websites as it may bring your knowledge "up to speed".
I read the whole FAQ before reading the manual. Then I read, probably too quickly, the whole manual before starting the install (probably why I missed the information linkage problem between the end of CH 5 and start of Ch 6). I DID miss a number of wiki pages which have since been pointed out. Ones that are not directly linked to from the manual or FAQ,,,
I will not be able to do too much this week, being at the IETF. I believe I have a tunnel setup back to the sme server so I can try things out IF I have the time...