i guess over time it will be documented, but as always i guess its a matter of priorities.
the idea is, in the future, the users will not have to interact with the XML, as the Object Editor will allow parameters/attributes and code all to be entered.
I learnt, by simply looking at existing objects and also the java code, it was not that hard really.
sha/uuid, yeah we need to abstract so this can be called from the command line.
basically uuid can be anything, and if you put an sha that is wrong, it will tell you its wrong, and what the correct one is.
(so I usually , when I'm not generating from java, copy an existing object, change the uuid and then just load it to get the correct sha)