Salt: Better docs for alt.states.linux_acl

[guettli]

Description of Issue/Question

One common use case if you use alt.states.linux_acl is that the file might not exist yet.

https://docs.saltstack.com/en/latest/ref/states/all/salt.states.linux_acl.html

I think it would improve the docs, if you provide an example which creates the file if it does not exist up to now.

It is 100% ok if you think different. Just close this issue. It is not very important.

[garethgreenaway]

@guettli Thanks for the report. An example of using the state module would be a great addition and we would welcome a pull request to include them.

[guettli]

Before providing a pull request, there needs to be agreement on how to solve this use case in salt.

I asked here: https://groups.google.com/forum/#!topic/salt-users/oekaS8gMLm4

and here: https://serverfault.com/questions/883742/saltstack-do-x-if-var-log-backup-exists

Please tell me which solution you would like to see in the docs.

Maybe it would be better to just provide a link to a cookbook entry on the salt.states.linux_acl.html page.

I think it is a general use case: "Do x if file/directory exists".

[guettli]

I got no reply at the salt users mailing list :-(

I don't know which is the prefered salty way to handle this.

This means, I can't create a pull request.

Do you have any advice what I could do now? Next step?

[stale[bot]]

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.

If this issue is closed prematurely, please leave a comment and we will gladly reopen the issue.