Operations example not working and wrong.

[robertmx]

Describe the bug

The example at https://github.com/pyinfra-dev/pyinfra/blob/3.x/docs/api/operations.md is wrong. The shown file example operation uses 'name' as first argument, which is explicitly forbidden and does not work.

To Reproduce

Write any operation that uses 'name' in it's argument list and observe an exception.

Expected behavior

An example in the docs, that actually works. An automated test battery to prevent wrong examples entering the docs. These are actually worse than no examples at all.

[robertmx]

Fixed by PR #1315. Please apply and close. Cheers.