I think the problem is expectations and clarity. I'm a rather advanced Apple user. I watch the Keynotes. I don't download developer tools or play around in beta, but I'm almost always the first to grab an update and mess around.
A day later, I honestly still don't understand the 'documents' part of iCloud.
What I want, simply, is to have my documents sync between my home computer, my work computer, my desktop, laptop, iPad, etc, so that any change I make on each device pushes the changes to all the devices. And I want a master copy in 'the cloud' so that if, for some absurd reason, my house, office, and every iDevice is consumed by a black hole I can grab a new laptop and have my documents.
Drop box does this with symlinks or whatever they're called. I'm still confused whether iCloud does this, if I've missed turning some magic button or or what.
I agree and wrote it earlier, "documents" part of the iCloud is now really poor. Documents creation is still the dominion of Mac. Yes, there is iWork for iOS and many others, but we know the reality. Perhaps as iOS and OS X merge even more into (likely) one operating system, we could see benefits. But, I am still hoping, that mentioned API for 3rd party application will allow developers to implement full sync - I am not a developer and do not know if it is possible now. I think OmniGroup has said something along the line, I keep my fingers crossed for CourseNotes, Curio, iDocument, MindNode and many others. And if not? Well, Dropbox