Is this text only confusing to me...? ("Replace this task with one that validates your content" in converge.yml)

[dragetd]

I am struggling to really wrap my head around all the concepts, I believe the documentation could use a few more example.

Beside this, initializing the standard layout creates a converge.yml file with a placeholder task with the name "Replace this task with one that validates your content"

molecule/src/molecule/data/templates/scenario/converge.yml.j2

Line 6 in 59858f4

- name: Replace this task with one that validates your content

and "This is the effective test"

With all I understood so far, converge.yml makes sure to setup the testable state. So in the simplest form, if I was testing a role, it would call the role here.

It would not "validate" anything, and it would not "test" my role. So the example text is highly confusing for me.

Am I getting something wrong?

[paulcalabro]

No, I think you're correct. That task looks like it performs a verification action so I would also expect it to go in a verify.yml file.

[dragetd]

I created a PR as a basis for discussion. #4476