Yeah, we are sparse on documentation right now. The Shield Shield is pretty simple but currently only exists in my head. My goal this month is to finish all shields, though with the software release coming up, that may bleed into april...
I think I will throw a couple level shifters onto the shield shield so people can more easily use it with 5v shields.