We are beginning to revise the FAQs for the 7.5 release. In addition to all the changes, there should be some additions such as the one that eriefisher has posted as a sticky here.

I have already a couple in mind, but would appreciate any suggestions from others. Even better, propose a Q and A for the suggested topic so I don't have to start empty. I am particularly interested in someone besides me drafting one on smxi, for instance, which I haven't tried myself.

TIA

The smxi script is pretty self explanatory. It may be a little scary for a beginner or someone not familiar with a console but you just basically answer the questions as you go.

OK, then can you give me a short *self-explanatory* statement of what it does that I can use?

I might write one up for the smxi home page,
========= SCRAPER REMOVED AN EMBEDDED LINK HERE ===========
url was:"http://techpatterns.com/h2"
linktext was:"http://techpatterns.com/h2"
====================================
(shortcut link)

That's a crude and somewhat outdated description, but it's not very readable because it's been expanded so often over time.

My current idea is to create a page that simply lists all the main sections with their functions, in a sort of hierarchical map.

What it does changes frequently, I add features, and now and then remove them, so the documentation has always been somewhat lacking and behind.

Basics:
system checks
kernel options
upgrade system
post upgrade options:
-package install
-package removal
-cleanup options
-misc tweaks (a variety of system tweaks)
-kernel option (same ones you see pre upgrade)
-virtual machine installer (starts the standalone module svmi)
-optional, if you start with -X scriptname#scripturl, will start any web based script you know about as an additional option in post upgrade options, for example: smxi -X extras#extras.webhop.net would add an option for the popular extras script, it would download it and start it when you selected that option.
and then the last step:
graphics install (interfaces with sgfxi, the graphics installer script, to tell user current available options for their video card type) sgfxi itself does the specific testing for card or kernel specific issues after it starts.

Most sections have subsections, so you can drill down, and back, into the options, using the navigation.

Obviously, the stuff most people will use most of the time runs either automatically or is at the top level of the navigation.

That's a big help, thanks!