Lack of documentation about scripts requests

[versatildefuy]

Hello,
first, thank you for the component, I'm found it really helpful to interoperate with security components.
In spite of this, it's really hard to understand what the component is really doing when a request is made. I mean, when you create a new service, requests to Keystone IDM and Keypass PAP are done creating roles and policies and no documentation is provided about those roles nor policies.
Could the documentation be extended to cover those aspects for each request?
Maybe I'm wrong and there is some guide explaining this. In that case, I'd really appreciate if you can point me out to this guide.
Thank you in advance

[AlvaroVega]

Full doc about scripts is available at https://github.com/telefonicaid/orchestrator/blob/master/SCRIPTS.md.