Insufficient docs, like setting the output variable from playbook

[abitrolly]

https://xlab-si.github.io/xopera-docs/cli.html#quickstart is awesome. Unfortunately, it ends with no links to expand details what didn't fit into the intro.

Like how to set an output variable from a playbook. Had to go through all files to find that this is done through standard set_stats Ansible module.

• https://github.com/xlab-si/xopera-examples/blob/e2b7a58067ee9ad283af3d933aaa793c3360387c/tosca/outputs/playbooks/create.yaml
• https://github.com/xlab-si/xopera-examples/blob/e2b7a58067ee9ad283af3d933aaa793c3360387c/tosca/outputs/service.yaml

It would be nice to see more tutorials that gradually introduce TOSCA concepts for Ansible users and how do they play together. What immediately comes in mind.

• Showing user level messages during deployment
• Setting output variables from a playbook
• Reading new parameter values as a result of deployment and passing then between nodes
• Setting different SSH access parameters for different nodes in the same deployment

[anzoman]

@abitrolly thank you for expressing your thoughts on our documentation and we know that things about TOSCA orchestration are not straightforward and that some infomation about TOSCA-Ansible combination is missing, so we will definitely use your check points above when improving our docs in the future.