In "4.2. Creating a New Resource",
there's "appTypeName" without explanation what's that value and where to get it.

I'd explicitely note that these values are available in rhq-plugin.xml
(or if it's avaiable somewhere in online docs, the better).

Also, in many CLI examples, there are variables used which are not created anywhere and there's no comment on what they are good for;
Even if you're familiar with RHQ GUI, it's not quite clear.
E.g.:

-------------------------------------------------------
ResourceFactoryManager.createPackageBackedResource(
    server.id,      
    appType.id,
    packageName,     <<<
    null,  // pluginConfiguration
    packageName,     <<<  Why twice?
    packageVersion,  <<<
    null, // architectureId    <<<
    deployConfig,    <<<
    fileBytes
);
-------------------------------------------------------


http://documentation-stage.bne.redhat.com/docs/en-US/JBoss_Operations_Network/2.4/html-single/CLI_Guide/index.html#Scripted_Group_Deployments_using_the_CLI_API-Creating_a_new_resource