Task/recipe roles are covered in 3 places: in the multihost testing guide, in the XML attribute docs in the relax-NG schema for the job XML and in the main job XML documentation. Setting "STANDALONE" or "None" as the task role isn't really needed any more, since the attribute is now optional. Roles should really only be set when you actually need them for a multihost test. For now, due to the fact that task roles are not shared between host recipes and guest recipes, recipe roles are preferred to task roles, unless you have a specific reason to use task roles (such as running the same test more than once between two recipes with different roles each time) The docs should be scanned for any references to task and recipe roles and updated to be consistent with the multihost testing guide. +++ This bug was initially created as a clone of Bug #960317 +++
Related to this, we should check that the limitations of guest roles are mentioned (in terms of whether or not the FQDNs have been populated yet), and ensure that the contents of the environment variables are correctly referred to as FQDNs rather than mere hostnames.