In elastic/integrations#3433, we're working on the first iteration of more detailed documentation guidelines for integrations (including template language). In that PR @jsoriano suggested:

elastic-package create package can be used to create an initial scaffolding for new packages, as a follow up we could apply these recommendations in the templates there.

We should do this after elastic/integrations#3433 is merged.

cc @jamiehynds @elastic/obs-docs