Thanks for the write-up, Art. Glad to see the architecture is "clicking" for you, and it will only get better as the supporting modules around entities / fields improve. For example, it's entirely likely we'll have our Entity Reference Field module as a dependency for Commerce 2.x, which would in turn make improving our Inline Entity Form into a dependency even more attractive. And then of course we have actual entity-specific classes in D8 to look forward to instead of stdClasses all over the place. The times they are a-changin'!

Additionally, your comments about the documentation and related "non-code" components of Drupal Commerce are taken to heart. I haven't officially announced him yet, as he doesn't start until May 7th, but d.o user joshmiller will be joining Commerce Guys in a week and a half to spearhead the documentation effort on DC.org and elsewhere. As it turns out, documentation just doesn't magically happen (who'da thunk it? ; ), so I'm looking forward to seeing what Josh can do to bring what we have up to date, complete it, and introduce some helpful videos / diagrams where possible.

Best of luck on your Commerce projects!