Clarify Usage of module.* in Advanced Example

[thomascjohnson]

Thank you for these helpful examples! The advanced example uses the module values app and env in the service template but it isn't clear how these values are populated. A comment in the readme or the template would help to clarify that the values come from the file structure per the AppEnvCluster.

[holzensp]

Whenever I'm unsure where a definition comes from, I use Go To Definition in my IDE to find it. It's also not documented where services comes from. Do you think the module style reference is so much harder to find / counter-intuitive that it warrants documenting, whereas a direct reference (to services) is not?

[thomascjohnson]

I was thinking that a comment clarifying this could save someone else the 10 minutes I lost on this in the future. I don't even get anything like "Go To Definition" when I am looking at this in VS Code, so that wouldn't have helped me either:

However, I did just find this in the readme:

This template mandates a three-level application/environment/cluster directory structure whose leaf directories contain the manifest files for a particular combination of application, environment, and cluster.

I missed that last night.