Determine Buttons in CCSM – How to Guide

I am an experienced Linux user, I've contributed to kernel and work on the Canonical OEM team; I only mention these facts to show my context, which is -- the other day, I did a fresh install of 11.10 on my laptop, and wanted to customize something (turning on focus-follows-mouse). I poked around in gnome-control-center for about 30 minutes before giving up and discovering the only way to do this was using ccsm.

After installing ccsm, I configured ffm, and then -- accidentally! -- my mouse cursor passed over the preferences button and the touchpad on my laptop registered a click.

Boom!

Unity session dead.

Luckily I still had an irc window open and I could beg for help from my colleagues who told me how to recover (rm ~/.compiz-1). This is the same problem some people keep having:

• Unity 3D doesn't work anymore, just shows a menu on the top
• Unity doesn't load, no Launcher, no Dash appears
• Desktop disappeared after messing with ccsm

I know that people are going to google for how to configure things and land up here and they're going to see lots of mentions of ccsm; or worse yet from another unreliable source. The horse is out of the barn already, and we can't go back. The determined users are going to find it anyway, and anyone that tenacious deserves to know how to get what they want (and if you break it you get to keep both pieces!)

But my point is that from now on, we can try and do better for our users.

1. ccsm is dangerous; even if you know not to touch the bad thing, you might accidentally touch it anyway like I did.
2. ccsm has no future; the future plans for Unity are to migrate all the useful configurability bits out of ccsm into safer, supported tools. These tools should start to appear in 12.04.
3. the attitude of "recovering from your mistakes is a positive learning experience" is niche. Most normal people just want to use their computers without having them randomly break in mysterious, non-recoverable ways; most normal people do not share our culture of taking things apart to see how they work.

Again -- I know that people are going to find the dangerous stuff no matter what. But what we can do here is change our culture and give opinionated help, steering people away from the bad stuff and towards the good stuff.

It's easy to convey facts; it's much harder to convey wisdom.

Here, we should be aiming higher than merely giving the facts of what is possible; we should be sharing the wisdom of what is recommended.