Description of problem:
These docs have a lot of inline template content, which would be best shipped via an RPM, e.g the openstack-tripleo-heat-templates RPM now has a roles data similar to the one described, and other yaml sections like the network config should probably also point to pre-packaged examples?
For example, here we have a pre-prepared role which can be referenced and is probably already packaged:
We should document consuming this via the new "roles generate" CLI described here which reduces the burden of rebasing custom roles_data between releases:
Elsewhere in the docs we should try to as far as is possible remove the cut/paste examples and instead reference files we package/test/ship so they're easier to consume and less likely to break between releases.
Is the ask to fix RHOSP12 documentation only? As only RHOSP10 and RHOSP13 are of interest, can we move this request on RHOSP13.z doc and also qualify what is the ask (if any) for RHOSP10?
The problem with OSP12 is that, it has only the ComputeOvsDpdk role file only and it does not have ComputeSriov role file. During the backport  of ComputeSriov, there was a concern raised regarding the backport affecting the existing Compute role during minor update in OSP12 (as SR-IOV service will be removed from Compute and added to the new role ComputeSriov).
But the new role is already present in the OSP13 templates and we will use the roles generate cli for both SR-IOV and OVS-DPDK roles. I don't think we have much to do here for OSP12 and it has been already taken care of OSP13. Closing the BZ, please re-open if you still think we need to fix OSP12 doc too.